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

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

‍

1. Входящие Webhook

• Запрос: https://api.pachca.com/webhooks/
• Лимит: ≈ 4 запроса
• Интервал: 1 секунда

Как считаем

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

Что произойдёт при превышении

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

‍

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

• Запросы: https://api.pachca.com/api/shared/v1
• Лимит: ≈ 50 запросов
• Интервал: 1 секунда

Как считаем

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

Что произойдёт при превышении

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

‍

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

• Запрос: POST https://api.pachca.com/api/shared/v1/messages/
• Лимит: ≈ 4 запроса в один чат
• Интервал: 1 секунда

‍

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

• Запрос: POST https://api.pachca.com/api/shared/v1/messages/
• Лимит: ≈ 30 запросов
• Интервал: 5 секунд

‍

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

• Запрос: PUT https://api.pachca.com/api/shared/v1/messages/
• Лимит: ≈ 4 запроса
• Интервал: 1 секунда

‍

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

• Запрос: DELETE https://api.pachca.com/api/shared/v1/messages/
• Лимит: ≈ 4 запроса
• Интервал: 1 секунда

‍

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

• Запрос: GET https://api.pachca.com/api/shared/v1/messages/
• Лимит: ≈ 10 запросов
• Интервал: 1 секунда

‍

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

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