GraphQL API

The GraphQL API of the Projections service is available at /delivery/graphql An API sandbox is available at /delivery/graphql/sandbox.

Sandbox

Use the sandbox to get an overview of the API that your schema configuration generates. The API will be generated on runtime depending on your current configuration.

Authenticate to the API by sending a valid JWT within the Authorization header as a bearer token: Authorization: Bearer replace.by.your.jwt

Real Time Updates

The graphql subscription api enables simple to use real time updates on all of your data. Even on complex view projections used for reporting.

Targets

The service differentiates between two deployment targets: blue and green. The GraphQL endpoints (/delivery/graphql and /delivery/graphql/sandbox) point to the blue target by default.

If you want to use a specific target, you can use the /delivery/graphql/blue or /delivery/graphql/green endpoints (/delivery/graphql/blue/sandbox or /delivery/graphql/green/sandbox).

X-Outdated Header

The X-Outdated header is set to true if the target is outdated. This is useful to indicate a new deployment target is active and the client should refresh the ui.