API Documentation

Using the API, we provide you with a low level method to access and create resources (data entities) via URI paths. The response format is JSON. The methods that are allowed to use on our API are the standard HTTP methods like GET, PUT, POST and DELETE.

API Access

To access our API, the API key from your station will have to be sent in the header of the request as "api-key". You will find a way to generate a API key in the station-settings, under the API header(Authentication REST API's). Please make sure you select the correct (V2) API Version.

Rate limiting

We provide our users with a fair use limit, which means that there is a limit based on server load. To check how many request you have remaining, you can check the response headers of the API calls, these will display useful information about your requests. The rate limit interval for our API is set to 15 minutes, which means that you can do a certain amount of request during a 15 minute time window.

• X-RateLimit-Limit: the rate limit ceiling for that given endpoint
• X-RateLimit-Remaining: the number of requests left for the 15 minute window

When you exceed the Rate limit, the API will return a HTTP 429 "Too Many Requests" response code. You can check when you are eligible with the following headers, which will only be returned once you have exceeded the limit.

• X-RateLimit-Reset: the epoch time after which you can do request to the API again
• Retry-After: the number of seconds left before you can do request to the API again