Introduction

warning draft documentation only this documentation is currently in draft status the system is under active development and some details may change over time where significant changes are anticipated, these will be highlighted with a callout block basic api information environments there are two environments available for integrators live (production environment) sandbox (testing environment used during integration) please note the following credentials issued for one environment are not valid in other environments live cards should only be used in the live environment test cards should never be used in the live environment the base urls for each environment are live environment https //mgmt api torogateway com sandbox environment https //mgmt api torogateway dev openapi/swagger documentation the documentation is served as json at https //mgmt api torogateway dev/v1/docs and via a swagger ui at https //mgmt api torogateway dev/v1/swagger ui these endpoints are protected by basic auth, using the same password as this archbee documentation and user user data format request payloads must be formatted as json (content type application/json ) versioning endpoint urls include a major version number (e g /v1 ) rate limiting to prevent abuse, rate limiting is enforced if the rate limit is exceeded, response with status code 429 too many requests will be sent authentication all api requests must be made over https requests made over plain http will fail api requests without authentication will also fail authentication can be achieved by setting a valid api key header or by authenticating and receiving a json web token (jwt) via the /tokens endpoint please see the openapi/swagger documentation for full details data structure to help integrators visualise the relations between different entities in our system, here is a diagram showing the major entity types