Limite de requisições
Cada conta tem um limite de requisições por segundo, de acordo com o plano, compartilhado por todas as suas chaves: Gratuito 5/s, Pro 200 20/s, Pro 1.000 50/s, Pro 5.000 100/s e Corporativo 200/s ou mais, conforme o contrato. Contas gratuitas nos primeiros 7 dias têm um limite menor. Nos lotes, o limite é contado por item (CPF enviado). Ao passar dele, a API responde 429 com o cabeçalho Retry-After, que informa em segundos quanto esperar.
Uma requisição que recebe 429 não consome crédito. Espalhe as chamadas no tempo ou use a consulta em lote para volumes grandes.
Cabeçalhos de limite
- X-RateLimit-Limit
- Requisições por segundo permitidas para a chave.
- X-RateLimit-Remaining
- Quantas ainda cabem na janela atual.
- X-RateLimit-Reset
- Quando a janela reinicia, em segundos desde 1970 (Unix).
- Retry-After
- Só no 429. Segundos de espera antes de tentar de novo.
429 Too Many Requests
1HTTP/1.1 429 Too Many Requests2Retry-After: 13X-RateLimit-Limit: 204X-RateLimit-Remaining: 05X-RateLimit-Reset: 17921592006 7{8 "error": "Rate limit exceeded",9 "message": "Muitas requisições. Aguarde antes de tentar novamente."10}