Необходимые cookie-файлы нужны для работы сайта. Аналитические cookie (Яндекс Метрика) — только с вашего согласия. Политика cookie-файлов

Тема оформления
СправочникКоды ошибок

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 — передайте его в поддержку.

HTTP 429 · application/problem+json
{
  "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"
}

Связанные коды

Все коды — в таблице «Коды ошибок».