Rate limit

Cada client pode fazer até 30 requisições por minuto. A cota é reabastecida aos poucos ao longo do minuto, não toda de uma vez: depois de uma rajada, as requisições voltam a passar em poucos segundos.

• Toda resposta de sucesso traz o header RateLimit-Remaining, com quantas requisições ainda cabem agora.
• Ao exceder, a API responde 429 Too Many Requests com o header Retry-After (em segundos). Espere esse tempo antes de tentar de novo.

HTTP/1.1 429 Too Many Requests
Retry-After: 2
Content-Type: application/problem+json

Requisição barrada pelo limite não chega a ser processada. Num POST, repita depois com a mesma Idempotency-Key: ela ainda não foi usada.

Boas práticasCopiar link da seção

• Reaproveite o access token por 5 minutos em vez de pedir um por chamada.
• Na sincronização de cobranças, use size=100 e janelas de data em vez de muitas páginas pequenas (veja Consulta de cobranças).
• Precisa de mais? Fale com a gente pelo Atendimento.