Analice cabeceras de límite y calcule el reinicio

Este analizador recibe el límite, la cantidad restante, el valor de reinicio y una hora actual explícita; después devuelve valores numéricos normalizados y los segundos completos que faltan para recuperar las solicitudes. Admite marcas Unix en segundos o milisegundos, fechas ISO 8601 UTC estrictas y desplazamientos numéricos breves. Como usted proporciona la hora actual, una misma entrada siempre genera el mismo resultado.

Normalice las cabeceras antes de programar reintentos

Las API suelen publicar un máximo de solicitudes, una cantidad restante y un valor de reinicio, pero el cliente aún debe convertir esas cadenas en una decisión segura. Envíe esos valores como limit, remaining y reset, e indique en current_time el instante en que recibió la respuesta. El analizador verifica que limit y remaining sean enteros no negativos y rechaza una cantidad restante superior al límite. Conserva el texto original de reset, informa si lo interpretó como marca temporal absoluta o desplazamiento en segundos y genera una hora Unix normalizada. El campo seconds_until_reset se redondea hacia arriba para impedir que usted reintente durante la última fracción del intervalo. Si el reinicio ya pasó, devuelve cero y nunca un número negativo. El resultado sirve para registros, middleware de reintentos, demoras de colas y pruebas sin repetir las mismas reglas en cada integración.

Comprenda cómo se distinguen las marcas y los desplazamientos

Los valores numéricos de reset siguen convenciones habituales. Un valor de al menos mil millones se interpreta como segundos Unix; a partir de cien mil millones se considera milisegundos Unix y se convierte a segundos. Los números menores no negativos se suman a current_time como desplazamientos. Así, 30 o 900 funcionan como demoras, mientras las marcas de época actuales siguen siendo absolutas. También puede usar una fecha UTC ISO 8601 estricta, como 2026-07-25T12:01:00Z, con milisegundos opcionales. El sufijo UTC evita supuestos de zona horaria. current_time admite los mismos formatos absolutos, pero nunca se trata como desplazamiento. La validación detecta fechas imposibles, horas inválidas, valores ausentes, números negativos y texto ajeno. Un reset ilegible genera un error de entrada, en vez de convertirse silenciosamente en cero y provocar reintentos inmediatos.

Use resultados deterministas en clientes y pruebas

Una política de reintentos debe separar el análisis de las decisiones. Use esta capacidad para establecer los datos de cuota y permita que su aplicación decida si espera, encola, reduce la concurrencia o muestra un aviso. current_time es explícito por una razón: ningún reloj del sistema, solicitud de red, configuración regional ni valor aleatorio puede alterar la respuesta. Esto permite que el cálculo del navegador coincida con el de la API y que las pruebas sigan estables meses después. Por ejemplo, un desplazamiento de 60 con una hora actual exactamente al mediodía siempre produce una marca un minuto posterior y sesenta segundos restantes. Las marcas anteriores a la hora indicada producen cero, algo útil con webhooks demorados o registros históricos. Esta herramienta no infiere cabeceras de proveedores ni elige el retroceso exponencial. Procesa los valores ya extraídos. El navegador es gratuito y cada llamada automatizada cuesta $0.002 por elemento.