Limites de requisição
429, cotas diárias e bloqueios — e como a sua integração deve reagir.
Protegemos a plataforma com limites técnicos por unidade. Os valores não são publicados e podem mudar; para ampliá-los, fale com o seu gerente.
| Resposta | X-RateLimit-Reason |
O que fazer |
|---|---|---|
429 rate-limited |
global-rate |
Espere o Retry-After (segundos) e repita |
429 rate-limited |
concurrency |
Menos requisições simultâneas; repita em instantes |
429 quota-exceeded |
quota-daily |
Cota diária de cobranças (quantidade ou valor) atingida; Retry-After vai até a meia-noite |
403 amount-above-limit |
— | Valor acima do permitido por cobrança |
403 access-blocked |
kill-switch |
Acesso bloqueado por segurança — não repita; fale com o gerente |
As respostas autenticadas trazem X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset (janela de 10
segundos). Os SDKs respeitam Retry-After automaticamente.
Boas práticas: evite consultas em laço (use webhooks); agrupe trabalho em lote; use backoff exponencial com jitter.