Introduction

GraphQL

The Voxel API is organised around GraphQL. Ymage chose GraphQL for our Voxel API because it offers significantly more flexibility for our integrators. GraphQL provides a complete and understandable description of the data in our API, gives you the power to ask for exactly what you need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.

Authentication

To authenticate with the GraphQL api, you need an API access token. This token can be requested by contacting support@ymage.com. Keep this token in a safe place. This token can be used as a bearer token for authenticating with the Voxel API.

Testing

To test out the API we recommend using GraphiQL or another standalone client (e.g., Postman or Insomnia)

Dates and times

All date/time arguments need to be in ISO 8601 format. Fields containing date/time will always be in ISO 8601 format.

  • Calendar dates: YYYY-MM-DD (e.g., 2021-03-17T09)
  • Date and time: YYYY-MM-DDThh:mm:ssZ (e.g., 2021-03-17T09:20:28.994Z)
# Method + URL
  POST https://api.ymage.com/graphql

# Headers
  - authorization: Bearer <your-api-token>
  - content-type: application/json