Errores 429 y límite de consultas
Rate limit
El límite estándar es de 60 consultas por minuto por conexión.
Cómo evitar los 429
Diez respuestas 402 o 429 consecutivas bloquean la conexión por 24 horas: revisa ¿Por qué se bloqueó mi conexión?. Lo que más lo provoca son las ráfagas: varias consultas en el mismo segundo.
- Envía las consultas secuencialmente, con una pausa breve entre cada una.
- Ante cualquier error, espera unos segundos antes de reintentar. No reintentes de inmediato.
- Lee
Retry-Aftercuando venga en un429y respétala. - Monitorea
X-RateLimit-Remainingen las respuestas exitosas: si baja mucho, espacia las llamadas. - Cachea en tu sistema los datos que no cambian a diario. Un caso real cachea la situación tributaria por 30 días y con eso su volumen real bajó a decenas de consultas al mes.
Las cabeceras disponibles:
| Cabecera | Significado |
|---|---|
X-RateLimit-Limit |
Tope de la ventana que aplica |
X-RateLimit-Remaining |
Consultas que aún puedes hacer |
X-RateLimit-Reset |
Momento en que se renueva la ventana |
Retry-After |
Segundos sugeridos antes de reintentar |
Si necesitas procesar muchos RUT, revisa ¿Puedo consultar miles de RUT en un solo proceso?.
En esta página
Última actualización el 02/10/2026
por Anonymous