Гайды
Rate limiting
Лимиты на количество запросов и заголовки ответов.
API ограничивает частоту запросов скользящим окном на команду и клиента. Лимит по умолчанию — 1000 запросов в минуту на сервис; отдельные операции (публичное подписание, отправка форм) имеют собственные, более строгие политики.
Каждый ответ содержит стандартные заголовки лимитов (IETF RateLimit headers, без префикса X-):
| Заголовок | Значение |
|---|---|
RateLimit-Policy | политика: 1000;w=60;name="default" |
RateLimit | сводка: limit=1000, remaining=997, reset=42 |
RateLimit-Limit | максимум запросов за окно |
RateLimit-Remaining | осталось запросов в текущем окне |
RateLimit-Reset | секунд до сброса окна |
При превышении лимита сервер возвращает 429 Too Many Requests в формате Problem Details с кодом RATE_LIMITED и заголовком Retry-After — количеством секунд до следующей попытки.
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json; charset=utf-8
Retry-After: 42
RateLimit-Remaining: 0Рекомендация: при получении 429 повторяйте запрос не раньше, чем через указанное в Retry-After число секунд, с экспоненциальной паузой при повторных отказах.