HTTP Responses

The API returns HTTP responses on each request to indicate the success or otherwise of API requests. The codes listed below are often used, and the API may use others. Note that 4xx and 5xx responses may be returned for any request and clients should cater for them.

Response Code

Description

401

Unauthorized -- The API Key was not authorised (or no API Key was found).

402

Payment Required -- The API is not available on your current plan.

403

Forbidden -- You do not have sufficient permission to access the requested resource.

404

Not Found -- The resource was not found.

405

Method Not Allowed -- The resource does not accept the HTTP method.

406

Not Acceptable -- The resource cannot return the client's required content type.

429

Too Many Requests -- The client has reached or exceeded a rate limit, or the server is overloaded.

500, 502, 503, 504

Server errors - something went wrong with Aerobotics' servers. These responses are most likely momentary operational errors (e.g. temporary unavailability), and, as a result, requests should be retried at least once.