Ограничения API и Webhook

Мы следим за стабильностью API, поэтому применяем ограничения на частоту запросов (RPS - количество запросов в секунду). Пороговые значения динамичны — они подстраиваются под нагрузку, но подобраны так, чтобы покрыть любые рабочие сценарии. Немного подробнее об их работе:

‍

1. Входящие Webhook

Как считаем
Счётчик привязан к идентификатору вебхука в пути. Для запроса /webhooks/user123 лимит отслеживается по user123.

Что произойдёт при превышении
Если за секунду на один идентификатор поступит более двух запросов, лишние вернут ответ 429 Too Many Requests. Заголовок Retry‑After подскажет, через сколько секунд можно повторить запрос.

‍

2. Публичное API

Как считаем
Запросы группируются по токену авторизации из заголовка HTTP_AUTHORIZATION: один токен — один лимит.

Что произойдёт при превышении
Если за одну секунду с одним токеном придёт более 50 запросов, сервис ответит 429 Too Many Requests. В Retry‑After будет указана точная пауза до следующей попытки.

‍

3. Отправка сообщений в один чат

‍

4. Отправка пакета сообщений

‍

5. Редактирование/удаление сообщений вчате

‍

6. Редактирование/удаление сообщений вчате

‍

7. Чтение сообщения в чате

‍

Что важно помнить

• Гибкость лимитов. Числа ориентировочные и могут меняться для бесперебойной работы сервиса.
• Комфортный запас. Пределы рассчитаны так, чтобы хватало под любые типовые задачи.
• Стратегия при 429. Смотрите Retry‑After, чтобы узнать, когда безопасно повторить запрос, либо используйте экспоненциальный backoff для надёжности.