Skip to main content

Endpoints

The OMS is available in two environments — Production and Staging — each exposing a Backend (the GraphQL API endpoint) and a Frontend (the OMS web application):

ProductionStaging
Backendhttps://api.oms.calicant.us/api/graphql/v1https://api.oms-staging.calicant.us/api/graphql/v1
Frontendhttps://oms.calicant.ushttps://oms-staging.calicant.us

Develop and test against staging: it is a safe environment where your calls do not affect real orders. Move to production only once your integration works end to end. Access tokens are issued by Calicantus — see Authentication for how to request one.

Backend (GraphQL API)​

The Backend URL is the endpoint your integration talks to: being GraphQL, it is a single URL — every query and mutation is sent to it as a POST request with a JSON body containing the query (and optional variables), a Content-Type: application/json header and an Authorization header carrying your access token. See Authentication for the header format and a complete curl example.

You can also run operations against this URL interactively, from the Playground built into these docs or from any GraphQL client (see Client setup).

Frontend (web application)​

The Frontend URL is the OMS web application, where the same data is managed through a browser. Your integration does not call it, but it is useful to visually verify what your API calls do — for example checking an order you just imported.