Rate limits
Лимит по умолчанию
Заголовок раздела «Лимит по умолчанию»500 запросов в минуту на аккаунт (команд-wide ceiling) - sliding window, бакет public-api:{accountId} суммирует трафик от ВСЕХ ключей + OAuth-токенов аккаунта. Этот лимит нельзя обойти добавлением новых ключей: 10 ключей × 500/мин ≠ 5000/мин, всё равно 500/мин на команду.
Индивидуальный лимит на ключ
Заголовок раздела «Индивидуальный лимит на ключ»Опционально для каждого ключа можно задать RateLimitPerMinute (1..500, default 500), бакет public-api-key:{id}. Полезно когда хочется ограничить «шумный» ключ (например тестовый скрипт), чтобы он не съел весь команд-бюджет. На каждый запрос проверяются ОБА бакета - превышение любого возвращает 429.
Если у ключа лимит выше команд-ceiling - он автоматически capping’уется до 500 (защита от legacy ключей в БД с большими значениями).
429 Too Many Requests
Заголовок раздела «429 Too Many Requests»При превышении сервер возвращает:
HTTP/1.1 429 Too Many RequestsRetry-After: 47Content-Type: application/json
{ "error": { "code": "rate_limited", "message": "Too many requests" }}Retry-After - секунды до следующего разрешённого запроса.
Best practices
Заголовок раздела «Best practices»- При получении 429 - спите
Retry-Afterсекунд и повторяйте (exponential backoff если хотите страховку). - Не делайте параллельных запросов в N потоков, если можно обойтись serial - лимит общий.
- Для bulk-операций используйте пагинацию (page=N, pageSize=200).
- Слушайте webhooks вместо polling - событийная модель эффективнее.