Ограничение частоты запросов

Как BoxHero API ограничивает частоту запросов для каждой команды и как выждать и повторить запрос.

Чтобы сервис стабильно работал для всех, BoxHero API ограничивает количество запросов, которые может отправить команда.

Лимиты действуют на команду

Все API-токены одной команды используют общие лимиты. Выпуск дополнительных токенов в одной команде не увеличивает лимит.

Когда лимит достигнут

API отвечает 429 и описанием ошибки с type, равным /errors/too-many-requests. Заголовки ответа сообщают, когда можно повторить попытку:

Заголовок	Описание
`Retry-After`	Сколько секунд подождать перед повторной попыткой
`RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`	Текущий лимит, число оставшихся запросов и время сброса лимита

Подождите время, указанное в Retry-After, и повторите запрос. Если вы отправляете много запросов подряд, распределяйте их во времени, а не отправляйте все сразу.