# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-15T03:39:11.123Z

## Página

- Título: Limites de requisição da API
- URL humana: https://agilize.app/docs/desenvolvedores/guias-integracao/limites-de-requisicao
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como respeitar o limite público da API Agilize e tratar excesso de requisições.

## Seções

- Limite público
- Quando o limite for excedido
- Boas práticas
- Guias relacionados

## Conteúdo da página

# 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 é:

1. aguardar alguns segundos após a primeira resposta `429`;
2. aumentar o intervalo a cada nova tentativa;
3. limitar o número de tentativas;
4. 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.

## Guias relacionados

- [Consultas, ordenação e filtros](/docs/desenvolvedores/guias-integracao/consultas-ordenacao-e-filtros).
- [Webhooks](/docs/desenvolvedores/guias-integracao/webhooks).
- [Endpoints da API](/docs/desenvolvedores/referencia-tecnica/api).