Errors
Maplerad attempts to handle all mistakes and errors as gracefully as possible.
We use industry standard HTTP codes to group errors and also use conventional HTTP response codes to indicate the success or failure of an API request.
2XX Status code
Codes in this range confirms your request worked as expected (no errors)
4XX Status Code
Codes in this range indicates that the request failed due to the information in the request or situational reasons (e.g. an insufficient balance or a validation error on the request).
5XX Status Code
Codes in this range are extremely rare and indicates an error occurred on our system.
| Status Code | Meaning |
|---|---|
| 200, 201, 202 | Everything works as expected. API request was successful |
| 400 | Bad request. Review the data sent in the request. Usually, this means a required piece of information is missing |
| 401 | Unauthorized. This happens when you provide an invalid or non-existent API key |
| 404 | Resource not found. |
| 429 | You are sending way too many API requests and have been rate-limited |
| 5XX | Something went wrong on our end. You should assume that we are being paged for all errors in this range |
Updated about 2 years ago