Ошибка 429 Too Many Requests

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

Ошибка 429 Too Many Requests

Коротко: ошибка 429 означает, что превышен лимит одновременных запросов на отправку в один канал. Сообщения становятся в очередь, но если очередь переполнена — платформа возвращает 429.

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

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

Симптом

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

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

На один канал действует ограничение — не более 5 одновременных запросов на отправку.

Сообщения становятся в очередь и отправляются асинхронно. Отправка и получение статуса не зависят друг от друга.

Если вы превысили лимит — платформа временно возвращает ошибку 429 для новых запросов.

Причины

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

Решения

Ограничьте количество одновременных запросов к одному каналу — не более 5.

Если нужно отправить много сообщений — поставьте их в очередь на своей стороне и отправляйте в API не более 5 одновременно на один канал.

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

Broadcasts API →

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

Контакты:

Что приложить к обращению

Если ошибка 429 повторяется регулярно — обратитесь в поддержку с данными для диагностики.

Что указать:

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

См. также

Обработка ошибок API

Форматы ошибок для каждого API

HTTP-коды ошибок

Полный справочник кодов ответа

Ошибка 401 и 403

Ошибки авторизации и прав

Справочные эндпоинты

Описание лимитов в справочных эндпоинтах

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