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
Seção intitulada “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. Os limites por segundo e por minuto se aplicam em conjunto, e os cabeçalhos da resposta informam o limite por minuto.
Quando você atinge o limite
Seção intitulada “Quando você atinge o limite”A API responde com 429 e um envelope de erro 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.
Se as requisições de um mesmo endereço IP falharem repetidamente na autenticação (mais de 30 vezes em 60 segundos), as requisições seguintes desse IP recebem 429, independentemente do token usado.