Частота запитів
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).