Limites de requisição da API
A API Agilize possui limite de requisições para manter o serviço estável e distribuir a capacidade entre as integrações.
Limite público
Considere o limite público documentado de 120 requisições por minuto. Planeje cada integração para permanecer abaixo desse volume.
Distribua as chamadas ao longo do tempo e evite executar grandes lotes de uma só vez. Um intervalo constante entre as requisições costuma ser mais previsível do que enviar todo o volume no início de cada minuto.
Quando o limite for excedido
Ao receber uma resposta HTTP 429, interrompa novas tentativas por um período e repita a chamada com espera progressiva.
Uma estratégia segura é:
- aguardar alguns segundos após a primeira resposta
429; - aumentar o intervalo a cada nova tentativa;
- limitar o número de tentativas;
- registrar a falha para processamento posterior, sem perder o item original.
Boas práticas
- Use paginação para percorrer listas grandes.
- Evite consultar repetidamente dados que podem ser mantidos em cache pela integração.
- Prefira webhooks quando precisar reagir a alterações, em vez de consultar o mesmo endpoint continuamente.
- Controle concorrência e volume em filas de processamento.
- Não faça repetição imediata e ilimitada depois de erros.