A API possui um limite de requisições por minuto e por mês.
Por minuto: 60 requisições
Por mês: 5000 requisições
Caso precise de mais requisições, consulte valores com nossa equipe de atendimento.
⏱️ Limite por Minuto (Throttling)
- Limite: 60 requisições por minuto
- Aplicado por: API Key
🔄 Comportamento
- Se excedido, a API responde com HTTP 429 - Too 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 60 requisições por minuto por estabelecimento.
- Distribua as requisições ao longo do tempo para evitar estouros no início do minuto.
-
Em caso de erro 429, adicione um tempo de espera antes de tentar novamente.
📅 Limite Mensal (Quota)
- Limite: 5.000 requisições por mês (padrão)
- Aplicado por: API Key
🔒 Comportamento
- Ao atingir o limite mensal, todas as requisições são bloqueadas com erro HTTP 429 até o início do próximo ciclo (mês seguinte).
- Não há aviso prévio de que a cota está se esgotando.
✅ Como lidar
- Monitore a quantidade de chamadas feitas mensalmente (ex: contador local ou log).
- Evite chamadas desnecessárias (ex: polling excessivo, chamadas duplicadas).
- Se possível, consolide chamadas em lotes ou cache resultados que não mudam com frequência.
🛠️ Boas práticas adicionais
- Evite chamadas simultâneas sem controle de volume.
- Use API Keys distintas por sistema ou cliente para segmentar limites.
- Se seu volume for maior que os limites, entre em contato para avaliar uma ampliação.