Documentation

Application Layer technical documentation.

• NQL documentation, the nscale query language. Read as PDF
• Plug-in FAQ, Plug-ins FAQ documentation (only in German)

REST

The Application Layer provides some data and services over the REST-API as a Web resource. The data representations XML and JSON are supported. HTML and plain text will partly be offered as a readable representation.

• REST documentation, an overview of the REST API. Read as PDF
• REST OpenAPI, explore with swagger-ui
• OpenAPI document, OpenAPI documentation for the REST API

GraphQL

The Application Layer provides almost all data and services over the GraphQL-API as a Web resource. The data representations JSON are supported. With GraphQL there are two tools available, GraphQL-Playground and Voyager. GraphQL-Playground serves as an interactive IDE, where queries can be tested live and the schema can be displayed. Voyager can be used to graphically display the full GraphQL schema.

• GraphQL documentation, an overview of the GraphQL API. Read as PDF
• GraphQL schema, the schema of GraphQL for NAPPL
• GraphQL Playground, the GraphQL IDE for better development workflows
• GraphQL Voyager, the graphical representation of GraphQL schema

Authentication

The access to Web resources of the Application Layer requires a HTTP authentication. There are the following HTTP authentications:

• Negotiate (Kerberos or NTMLv2)
• NTLM
• Basic

When using SSL, the server certificate should be loaded into the client certificate store. Here is the Application-Layer certificate to download .

For your own CA, you must request a CSR (Certificate Signing Request):
keytool -certreq -file newreq.pem -keystore certificates.store -alias applicationlayer -ext san=dns:fully-qualified-hostname

Sign the file 'newreq.pem' (e.g. by http://active-directory/certsrv) and import the answer:
keytool -import -trustcacerts -keystore certificates.store -alias applicationlayer -file "certnew.p7b"

Application Layer instances

Here you can enter at the Application Layer REST based instances.

• Instance "nscalealinst1"
• Instance "nscalealinst1" (Basic Auth)