rate_limit_exceeded
Requests are arriving too quickly on this credential.
Status
HTTP 429, title Rate limit exceeded. One of the limits errors. Branch on code, never on the status or the prose.
Retryable: yes. Every body carries this as retryable: true, beside action and remedy: the same request can succeed later, after a backoff or the wait the response names.
Common causes
- More than the per-key limit of 60 requests per minute, free reads included.
What to do
Action: Wait retry_after_seconds, then retry the same request.
Too many requests on this credential. Wait the seconds in Retry-After and retry.
Example
The body arrives as application/problem+json, with retryable and the remedy above. Most responses add detail about the occurrence, and some add fields of their own.
{
"type": "https://www.shortsintel.com/docs/reference/errors/rate_limit_exceeded",
"title": "Rate limit exceeded",
"status": 429,
"code": "rate_limit_exceeded",
"retryable": true,
"action": "Wait `retry_after_seconds`, then retry the same request.",
"remedy": "Too many requests on this credential. Wait the seconds in `Retry-After` and retry."
}