Qué significa
El cliente envió demasiadas peticiones en un tiempo dado (limitación de tasa). Retry-After puede indicar cuánto esperar.
Causas habituales
- Se superaron los límites o cuotas de la API
- Bucles de reintento sin espera progresiva
- Muchos usuarios detrás de una IP compartida
Cómo solucionarlo
Si eres el cliente o visitante
Respeta Retry-After, usa espera exponencial con variación aleatoria, guarda resultados en caché y agrupa peticiones.
Si administras el sitio o la API
Devuelve Retry-After y cabeceras RateLimit para que los clientes se adapten, y limita por clave o usuario, no solo por IP.
Respuesta de ejemplo
HTTP/1.1
HTTP/1.1 429 Too Many Requests
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 30
RateLimit-Policy: 100;w=60
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Too Many Requests",
"status": 429,
"detail": "Rate limit of 100 requests per minute exceeded."
}Especificación
Preguntas frecuentes
› ¿Cuánto debo esperar tras un 429?
Usa Retry-After si existe; si no, espera de forma exponencial, por ejemplo 1, 2, 4, 8 segundos con variación aleatoria.
› ¿El 429 perjudica el SEO?
Googlebot reduce el rastreo cuando ve 429. Episodios cortos no importan; los largos pueden retrasar la indexación.