> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/ru/developers/api/rate-limiting.md).

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

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

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

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

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

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

API отвечает `429` и [описанием ошибки](https://www.boxhero.io/docs/ru/developers/api/errors) с `type`, равным `/errors/too-many-requests`. Заголовки ответа сообщают, когда можно повторить попытку:

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

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

> **Note**
>
> Лимиты могут меняться. Считывайте их из заголовков ответа, а не задавайте частоту жёстко в своём клиенте.