If you forget to include the X-Api-Key header or use the wrong API key, API will respond with 401 HTTP status code.
Requests
For every POST and PUT request set the Content-Type header to:
Content-Type: application/json; charset=utf-8
Responses
When an API call succeeds, the API will return a 200 or 201 HTTP response and a JSON response body unless otherwise noted.
If there's an error, the API will return an HTTP response in the 400 or 500 range and a response body indicating what the error was. For example:
{ error: "Subscriber uuid blank!"} with a 400 error.
Rate limiting
Our rate limit is no more than 60 requests over a rolling 60 second period, for a given api key.
If your request rate exceeds our limits, you will receive a 429 response, which your code should gracefully handle. We recommend spacing out your requests and performing an exponential backoff to keep within the limit.
Internal server errors
If the server is overloaded or you encounter a bug, you will get a 500 error. Try again after a short period, and if you continue to encounter an error, please raise the issue with support.