Cabeceras de límite de consultas: Retry-After y X-Ratelimit-Reset

13/08/2026

Ampliamos la información de límite de consultas que devuelve la API. Es un cambio aditivo: no cambia ningún límite ni el formato de las respuestas, solo añade cabeceras.

Retry-After en las respuestas 429. Indica los segundos que debes esperar antes de reintentar. Hasta ahora las respuestas 429 no la incluían y no había forma de saber cuánto duraba el bloqueo.
X-Ratelimit-Reset en todas las respuestas. Timestamp UNIX del momento en que la ventana se renueva y X-Ratelimit-Remaining vuelve a su máximo. Junto a X-Ratelimit-Remaining te permite espaciar las peticiones al acercarte al límite, en lugar de detenerte en seco o chocar contra el 429.

HTTP/1.1 429 Too Many Requests
X-Ratelimit-Limit: 80
X-Ratelimit-Remaining: 0
X-Ratelimit-Reset: 1786012860
Retry-After: 37

X-Ratelimit-Reset es un instante absoluto, no una cuenta atrás: se mantiene igual en todas las respuestas de la misma ventana y solo avanza cuando el cupo se renueva.

La tabla completa de cabeceras está en Límites de consultas.

Si tu cliente ya implementaba una espera propia tras un 429, puedes sustituirla por el valor de Retry-After. La mayoría de librerías HTTP la respetan de forma automática.