Límite de solicitudes
Cada cuenta tiene un límite de solicitudes por segundo según el plan, compartido por todas sus claves: Gratuito 5/s, Pro 200 20/s, Pro 1.000 50/s, Pro 5.000 100/s y Corporativo 200/s o más, según el contrato. Las cuentas gratuitas nuevas tienen un límite menor durante sus primeros 7 días. En los lotes, el límite cuenta ítems (CPF enviados). Al superarlo, la API responde 429 con el encabezado Retry-After, que informa en segundos cuánto esperar.
Una solicitud que recibe 429 no consume crédito. Reparta las llamadas en el tiempo o use la consulta por lotes para volúmenes grandes.
Encabezados de límite
- X-RateLimit-Limit
- Solicitudes por segundo permitidas para la clave.
- X-RateLimit-Remaining
- Cuántas más caben en la ventana actual.
- X-RateLimit-Reset
- Cuándo se reinicia la ventana, en segundos desde 1970 (Unix).
- Retry-After
- Solo en el 429. Segundos de espera antes de reintentar.
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}