Skip to content

API Errors

The API may return unexpected HTTP status codes, which can indicate various types of errors, from input validation issues to authorization problems and server exceptions.

Common API Errors

Input errors:

  • 400 Bad Request: The request body cannot be processed. This typically indicates a client-side issue, and the response should include detailed information about the error.

Authorization errors:

  • 401 Unauthorized: The API Key could not be detected. Ensure you have included either the URL parameter ?apiKey=... or the Authorization: Bearer ... header.
  • 403 Forbidden: The API Key may not match the Referer header. Ensure you send a valid Referer header with an appropriate origin, and that the API Key was created for the same domain.
  • 429 Too Many Requests: You have exceeded the maximum number of allowed requests. Please refer to the rate limits documentation for further information.

Make sure to handle these errors appropriately in your application logic.