API Reference
Onomondo provides an HTTP RESTful Application Programming Interface (API) for easy programmatic management of the different features.
The API is a HTTP RESTful API based around resource oriented URLs. It uses standard HTTP verbs and returns JSON on all requests where a data response is expected.
The API is served over TLS (HTTPS) to ensure data privacy, unencrypted HTTP is not supported—or rather will result in a redirect to HTTPS.
Authorization
To use the API an API key is needed. API keys can be generated in the platform and are coupled to the organization under which it is created. It is possible to have API keys with more or less access. This can be done so through Tags.
Once you have generated your API key, you need to add it into the header of all HTTP requests made. We utilize the Authorization header for this purpose, e.g.:
Authorization: <YOUR_API_KEY>Rate limiting
Every minute a user can send 600 API calls to our server, averaging to one every 0.1 seconds. You can monitor the API limits in the response headers.
x-ratelimit-limitis a number that informs you of the maximum amount of calls that can be made per period in total.x-ratelimit-remainingis a number that informs you of how many calls you have left in the current period.x-ratelimit-resetis an epoch/Unix timestamp informing you of when the period will be reset, i.e. at this point in timex-ratelimit-remainingwill be reset.
x-ratelimit-limit: 600
x-ratelimit-remaining: 520
x-ratelimit-reset: 1730239201Which would indicate that at this point in time you have 520 calls left in the given period and that they will be reset at 1730239201 (Tuesday, October 29, 2024 11:00:01 PM GMT+01:00), meaning that in the current period 600 - 520 = 80 calls were already made.
Response limits
Each response can return a maximum of 1000 objects and the default limit can vary per endpoint. If more objects for a given endpoint is required then consult the pagination method of said endpoint.
Last updated