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):

	Production	Staging
Backend	https://api.oms.calicant.us/api/graphql/v1	https://api.oms-staging.calicant.us/api/graphql/v1
Frontend	https://oms.calicant.us	https://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.