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

Как 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, и повторите запрос. Если вы отправляете много запросов подряд, распределяйте их во времени, а не отправляйте все сразу.

Если запросы с одного IP-адреса многократно не проходят аутентификацию (более 30 раз за 60 секунд), все дальнейшие запросы с этого IP получают 429 независимо от используемого токена.