СправочникКоды ошибок
rate_limited
Превышен лимит запросов
HTTP 429Ошибка APIПовтор может помочь
Причина
Превышен лимит запросов — на ключ API или пользователя, на организацию, на маршрут или на IP-адрес.
Что делать
Снизьте частоту запросов и подождите время из заголовка «Retry-After» — подробнее в «Лимиты».
Повтор может помочь: тот же запрос без изменений может пройти позже.
Пример ответа
API отвечает HTTP-статусом 429 и телом application/problem+json (RFC 9457), в поле code — rate_limited. Ветвитесь по code; detail — текст для человека, param — поле запроса, если ошибка относится к нему, request_id — передайте его в поддержку.
{
"type": "https://docs.typizer.ru/errors/rate_limited",
"title": "Rate limited",
"status": 429,
"detail": "Rate limited",
"code": "rate_limited",
"request_id": "req_0196f3a2-8b1c-7d4e-9a5f-1c2d3e4f5a6b",
"doc_url": "https://docs.typizer.ru/errors/rate_limited"
}Связанные коды
upstream_unavailable— Сервис обработки временно недоступен
Все коды — в таблице «Коды ошибок».