> 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/pt/developers/api/rate-limiting.md).

# Limite de requisições

> Como a API do BoxHero limita a taxa de requisições por equipe e como aguardar e tentar novamente.

Para manter o serviço estável para todos, a API do BoxHero limita quantas requisições uma equipe pode enviar.

## Os limites são por equipe

Todos os tokens de API que pertencem à mesma equipe compartilham os mesmos limites. Emitir mais tokens em uma equipe não aumenta o limite.

## Quando você atinge o limite

A API responde com `429` e um [envelope de erro](https://www.boxhero.io/docs/pt/developers/api/errors) cujo `type` é `/errors/too-many-requests`. Os cabeçalhos da resposta informam quando você pode tentar novamente:

| Cabeçalho | Descrição |
| --- | --- |
| `Retry-After` | Segundos a aguardar antes de tentar novamente |
| `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` | O limite atual, as requisições restantes e quando o limite é redefinido |

Aguarde e tente novamente depois do tempo indicado em `Retry-After`. Se você enviar muitas requisições seguidas, distribua-as ao longo do tempo em vez de enviá-las todas de uma vez.

> **Note**
>
> Os limites podem mudar. Leia-os dos cabeçalhos da resposta em vez de fixar uma taxa no código do seu cliente.
