API possui um limite de requisições por minuto para garantir a estabilidade do sistema.
⏱️ Limite por Minuto (Throttling)
Limite
- 30 requisições por minuto
- Aplicado por: API Key (header
ACCESS-TOKEN)
📨 Comportamento
- Se excedido, a API responde com HTTP 429 - To Many Requests
- Enquanto o limite estiver excedido, novas requisições continuarão falhando com 429 até que o minuto atual se renove
✅ Como lidar
Implemente controle de taxa no seu sistema:
- No máximo 30 requisições por minuto por API Key
- Distribua as requisições ao longo do tempo para evitar estouros no início do minuto
- Em caso de erro 429 por rate limit, adicione um tempo de espera antes de tentar novamente
Importante
A API não retorna corpo na resposta quando o rate limit é excedido. Somente o status HTTP 429 é retornado quando o limite é excedido.