| title | Errors |
|---|---|
| nav_order | 9 |
4xx HTTP status codes means you made a mistake and you need to adjust your request.
API usage error. This means you did something wrong and there should be a message in the body that explains it. Error message is related to specified resource. Fix it and try again.
Example response:
{
"title": [
"is a required field. Cannot be empty"
]
}Authentication error. Response body will give explanation if there is an authentication issue or if the API is not enabled.
Please pay your bill.
Authorization error. If you are authenticated but lack permissions.
Obviously incorrect paths (/cats) returns 404. However, even though cool URIs should not change, previously available objects, let's say /resources/666, might have been deleted and thus return a 404 when requested. In most cases deleted resources will be returned and have a state or a flag that indicates that the resource is inactive or deleted.
You can perform up to 80 requests per 20 second period from the same IP address. If you exceed this limit, you'll get a 429 Too Many Requests response for subsequent requests. Check the Retry-After HTTP-header to see how many seconds to wait before retrying the request.
System errors (aka we screwed up) returns 5xx HTTP status codes without any detailed information. We log all system errors, but please contact us if you get this response.
{
"error": "system error"
}