Limites da API

A API possui três tipos de limite. Quando um limite aplicável é ultrapassado, a requisição retorna HTTP 429 Too Many Requests.

Rate limit

Determinados endpoints possuem limites próprios de frequência.

Consulte os headers da resposta para acompanhar o consumo:

RateLimit-Limit: 100
RateLimit-Remaining: 50
RateLimit-Reset: 30

Quando RateLimit-Remaining chegar a 0, novas requisições podem retornar HTTP 429 Too Many Requests. Aguarde o período indicado em RateLimit-Reset antes de tentar novamente.

Limite de cota

Cada conta pode realizar até 25.000 requisições em um período de 12 horas, independentemente dos endpoints utilizados.

A janela começa na primeira requisição. As chamadas realizadas nas 12 horas seguintes são contabilizadas nessa cota. Após esse período, o contador é reiniciado.

Ao atingir o limite, a API retorna HTTP 429 Too Many Requests.

Limite de requisições concorrentes

Uma requisição é considerada concorrente quando é enviada antes que uma requisição anterior tenha sido respondida.

A API permite até 50 requisições GET concorrentes por conta.

As chamadas que ultrapassarem esse limite retornam HTTP 429 Too Many Requests.

Como tratar o erro 429

Identifique qual limite foi atingido antes de realizar uma nova tentativa.

Não execute retries imediatamente após uma resposta 429.

Para diagnóstico e estratégias de controle de tráfego, consulte Requisições bloqueadas por ausência de controle de limites.

Próximos passos

• Resolva requisições bloqueadas por ausência de controle de limites
• Entenda quando utilizar Polling ou Webhooks
• Consulte os códigos HTTP das respostas