Перейти к содержимому

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 ключей в БД с большими значениями).

При превышении сервер возвращает:

HTTP/1.1 429 Too Many Requests
Retry-After: 47
Content-Type: application/json
{
"error": {
"code": "rate_limited",
"message": "Too many requests"
}
}

Retry-After - секунды до следующего разрешённого запроса.

  • При получении 429 - спите Retry-After секунд и повторяйте (exponential backoff если хотите страховку).
  • Не делайте параллельных запросов в N потоков, если можно обойтись serial - лимит общий.
  • Для bulk-операций используйте пагинацию (page=N, pageSize=200).
  • Слушайте webhooks вместо polling - событийная модель эффективнее.