IBA Platform
docs

Ошибка 429 Too Many Requests

Что делать при превышении лимита запросов к API

Ошибка 429 Too Many Requests

Коротко: ошибка 429 означает, что вы превысили лимит запросов. Уменьшите частоту или обратитесь в поддержку.

Кому подходит

  • Роль: Разработчик
  • Уровень: Опытный

Симптом

API возвращает код 429 с текстом Too Many Requests.

Что это значит

Платформа ограничивает количество запросов в секунду от одного API-ключа. Это защита от перегрузки. Если вы превысили лимит — платформа временно блокирует новые запросы.

Причины

ПричинаЧто происходит
Слишком много запросов в секундуПревышен лимит
Параллельные запросыМного одновременных
Массовая рассылка без очередиСлишком частые вызовы
Цикл без задержкиЗапросы подряд

Решения

Решение 1. Уменьшите частоту

  1. Добавьте задержку между запросами.
  2. Используйте асинхронные очереди.
  3. Ограничьте количество параллельных запросов.

Решение 2. Используйте batch-запросы

Если нужно отправить много сообщений — используйте пакетные эндпоинты (если доступны) или рассылку вместо отдельных запросов.

Решение 3. Используйте рассылки

Если вы отправляете много сообщений через API, рассмотрите возможность создания рассылки через личный кабинет. Это снизит нагрузку на API.

Решение 4. Обратитесь в поддержку

Если лимит критично низкий для вашей задачи — обратитесь в поддержку. Возможно, лимит можно увеличить.

Как правильно обрабатывать 429

  1. Используйте retry с задержкой. Увеличивайте паузу после каждой неудачной попытки.
  2. Логируйте ошибки. Записывайте requestId и время.
  3. Не повторяйте сразу. Подождите 1–2 секунды.
  4. Используйте exponential backoff. Увеличивайте паузу постепенно.

Профилактика

  1. Планируйте нагрузку. Не отправляйте всё сразу.
  2. Используйте очереди. RabbitMQ, Kafka, Redis Queue.
  3. Тестируйте на малых объёмах. Перед массовой отправкой.
  4. Следите за метриками. Логируйте количество запросов.

Что делать, если лимит постоянно превышается

Обратитесь в поддержку:

Укажите:

  • Ваш сценарий использования.
  • Количество запросов в секунду.
  • requestId из ошибки.
  • Время проблемы.

См. также

Нужна помощь?