Analysez les en-têtes de limite et calculez la réinitialisation

Cet analyseur reçoit la limite, le solde restant, la valeur de réinitialisation et une heure actuelle explicite, puis renvoie des nombres normalisés et le délai complet avant la reprise des requêtes. Il reconnaît les horodatages Unix en secondes ou millisecondes, les dates UTC ISO 8601 strictes et les courts décalages numériques. Puisque vous fournissez l’heure actuelle, une entrée identique produit toujours le même résultat.

Normalisez les en-têtes avant de planifier une nouvelle tentative

Les API publient souvent un maximum de requêtes, un solde et une valeur de réinitialisation, mais le client doit encore transformer ces chaînes en décision sûre. Envoyez-les comme limit, remaining et reset, puis indiquez dans current_time l’instant de réception. L’analyseur vérifie que limit et remaining sont des entiers positifs ou nuls et refuse un solde supérieur à la limite. Il conserve le texte reset, précise s’il s’agit d’un horodatage absolu ou d’un décalage en secondes, et produit une heure Unix normalisée. seconds_until_reset est arrondi au supérieur afin que vous ne réessayiez pas pendant la dernière fraction du délai. Si l’échéance est passée, l’attente vaut zéro, jamais une valeur négative. Le résultat convient aux journaux, intergiciels de reprise, files d’attente et scénarios de test sans répéter ces règles dans chaque intégration.

Distinguez horodatages et décalages

Les valeurs numériques de reset suivent les conventions courantes. À partir d’un milliard, elles représentent des secondes Unix; à partir de cent milliards, des millisecondes Unix converties en secondes. Les nombres positifs ou nuls plus petits sont ajoutés à current_time. Ainsi, 30 ou 900 servent de délais, tandis que les horodatages modernes restent absolus. reset accepte aussi une date UTC ISO 8601 stricte telle que 2026-07-25T12:01:00Z, éventuellement avec des millisecondes. Le suffixe UTC évite toute hypothèse de fuseau. current_time accepte les mêmes formats absolus, jamais un décalage. La validation repère dates impossibles, heures invalides, absences, nombres négatifs et textes étrangers. Une valeur reset illisible déclenche une erreur de saisie au lieu de devenir silencieusement zéro, car une reprise immédiate peut renforcer la limitation et prolonger une panne.

Obtenez des résultats déterministes dans vos clients et tests

Une stratégie de reprise doit séparer l’analyse de la décision. Utilisez cette capacité pour établir les faits du quota, puis laissez votre application attendre, mettre en file, réduire la concurrence ou afficher un message. current_time est explicite: aucune horloge système, requête réseau, configuration régionale ou valeur aléatoire ne modifie la réponse. Le calcul du navigateur correspond donc à celui de l’API et les tests restent stables. Un décalage de 60 à midi produit toujours un horodatage une minute plus tard et soixante secondes restantes. Une échéance antérieure donne zéro, ce qui aide avec les webhooks retardés et journaux archivés. L’outil ne déduit pas les en-têtes propres à un fournisseur et ne choisit pas le recul exponentiel. Il traite vos valeurs déjà extraites. Le navigateur est gratuit; les appels automatisés utilisent le prix de base affiché de $0.002 par élément.