Частота запросов
Request rate
Все действующие сервисные ключи организации используют общий лимит запросов — для всех HTTP-маршрутов и экземпляров API. Организации с одного IP не мешают друг другу. Ротация и выпуск новых ключей не увеличивают лимит. Анонимные и пользовательские запросы сохраняют ограничение по IP и маршруту; ограничения auth остаются 5 или 20 запросов в минуту.
| Вікно / Окно | Ліміт / Лимит | Env |
|---|---|---|
| 60 s | 300 | REQUEST_RATE_ORG_MINUTE |
| 3600 s | 18 000 | REQUEST_RATE_ORG_HOUR |
| 86400 s | 432 000 | REQUEST_RATE_ORG_DAY |
Окно начинается с первого принятого запроса. Отказы не продлевают окно. При исчерпании нескольких окон возвращается самое долгое ожидание. Принятый ограничителем запрос учитывается даже при последующей ошибке проверки.
HTTP 429 TOO_MANY_REQUESTS содержит details { scope: "organization", limit, windowSeconds, retryAfterSeconds } и заголовок Retry-After в секундах. Подождите не меньше указанного времени, добавьте случайную задержку и сохраните ключ идемпотентности операции. AGENT_CONCURRENCY_LIMIT — отдельный код: дождитесь завершения активного хода; Retry-After: 1 задаёт минимальный интервал опроса.
Месячный QUOTA_EXCEEDED с scope: org_spend означает исчерпание бюджета организации за календарный месяц UTC. limit и used — строки в USD pico (1 доллар = 10^12 pico). Поднимите бюджет или дождитесь periodEndsAt; короткий Retry-After не возвращается. Изменения бюджета учитываются примерно через 10 секунд.
Чтобы увеличить лимит, обратитесь к администратору платформы: Organizations → организация → Settings & approval → Request rate. Пустое поле возвращает значение из окружения. Изменение журналируется и действует со следующего запроса без сброса счётчиков.
PATCH /v1/admin/orgs/{orgId}/request-rate: requestRateMinute, requestRateHour, requestRateDay (1–2147483647 / null).