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

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

1. Входящие вебхуки (/webhooks/)

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

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

2. Публичное API (/api/shared/v1/)

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

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

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

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

‍

‍