Analisi degli header di limite e calcolo del ripristino

Questo analizzatore riceve limite, quota residua, valore di ripristino e ora corrente esplicita, quindi restituisce numeri normalizzati e i secondi interi prima che le richieste tornino disponibili. Riconosce timestamp Unix in secondi o millisecondi, date UTC ISO 8601 rigorose e brevi differimenti numerici. Poiché è Lei a fornire l’ora corrente, lo stesso input produce sempre lo stesso risultato.

Normalizzi gli header prima di pianificare nuovi tentativi

Le API comunicano spesso un numero massimo di richieste, una quota residua e un valore di ripristino, ma il client deve ancora trasformare queste stringhe in una decisione sicura. Invii i valori come limit, remaining e reset e specifichi in current_time l’istante di ricezione. L’analizzatore verifica che limit e remaining siano interi non negativi e rifiuta una quota residua superiore al limite. Conserva il testo reset, indica se è stato letto come timestamp assoluto o differimento in secondi e produce un’ora Unix normalizzata. seconds_until_reset viene arrotondato verso l’alto, impedendo un nuovo tentativo nell’ultima frazione dell’attesa. Se il ripristino è già passato, il risultato è zero e mai negativo. L’output è adatto a log, middleware, ritardi di coda e test senza replicare le stesse regole in ogni integrazione.

Distingua timestamp e differimenti

I valori numerici di reset seguono convenzioni comuni. Da un miliardo in su sono secondi Unix; da cento miliardi sono millisecondi Unix convertiti in secondi. I numeri più piccoli non negativi vengono aggiunti a current_time. Pertanto 30 o 900 sono attese, mentre i timestamp moderni restano assoluti. reset accetta anche una data UTC ISO 8601 rigorosa come 2026-07-25T12:01:00Z, con millisecondi facoltativi. Il suffisso UTC evita ipotesi sul fuso orario. current_time accetta gli stessi formati assoluti, ma non è mai un differimento. La convalida rileva date impossibili, ore errate, valori assenti, numeri negativi e testo estraneo. Un reset illeggibile genera un errore di input anziché diventare silenziosamente zero, perché un tentativo immediato accidentale può aggravare la limitazione e prolungare un disservizio.

Usi risultati deterministici nei client e nei test

Una politica di ripetizione deve separare l’analisi dalla decisione. Usi questa capacità per stabilire i dati della quota, poi lasci all’applicazione la scelta di attendere, accodare, ridurre la concorrenza o mostrare un messaggio. current_time è esplicito: orologio di sistema, rete, impostazioni locali e casualità non possono cambiare la risposta. Il calcolo nel browser coincide così con quello dell’API e i test restano stabili nel tempo. Un differimento di 60 a mezzogiorno genera sempre un timestamp un minuto dopo e sessanta secondi residui. I ripristini precedenti producono zero, utile per webhook in ritardo o log archiviati. Lo strumento non deduce header specifici né sceglie il backoff esponenziale; tratta i valori già estratti. Il browser è gratuito, mentre le chiamate automatizzate applicano il prezzo base mostrato di $0.002 per elemento.