ForHosting KIT · Entwickler-Tools

Rate-Limit-Header auswerten und Rücksetzzeit berechnen

Rate-Limit-Header wirken einfach, bis verschiedene Dienste den Rücksetzzeitpunkt unterschiedlich angeben.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Dieser Parser übernimmt Limit, Restkontingent, Rücksetzwert und eine ausdrücklich angegebene aktuelle Zeit. Er liefert normalisierte Zahlen sowie volle Sekunden bis zur erneuten Verfügbarkeit von Anfragen. Er erkennt Unix-Zeitstempel in Sekunden oder Millisekunden, strikte UTC-Zeitangaben nach ISO 8601 und kurze numerische Zeitabstände. Da Sie die aktuelle Zeit vorgeben, führt dieselbe Eingabe in Tests, Browsern und API-Integrationen stets zum selben Ergebnis.

Normalisieren Sie Header vor der Wiederholungsplanung

APIs nennen häufig eine maximale Anfragezahl, das Restkontingent und einen Rücksetzwert. Der Client muss diese Zeichenfolgen jedoch noch in eine sichere Entscheidung umwandeln. Übergeben Sie die Werte als limit, remaining und reset und tragen Sie in current_time den Empfangszeitpunkt ein. Der Parser prüft, ob limit und remaining nicht negative Ganzzahlen sind, und weist ein Restkontingent oberhalb des Limits zurück. Er bewahrt den ursprünglichen reset-Text, nennt die Interpretation als absoluten Zeitstempel oder Sekundenabstand und erzeugt eine normalisierte Unix-Zeit. seconds_until_reset wird auf volle Sekunden aufgerundet, damit Sie nicht im letzten Sekundenbruchteil erneut anfragen. Liegt die Rücksetzung in der Vergangenheit, beträgt die Wartezeit null statt eines negativen Werts. Das Ergebnis eignet sich für Protokolle, Retry-Middleware, Warteschlangenverzögerungen und Testdaten, ohne diese Regeln in jeder Integration neu umzusetzen.

Unterscheiden Sie Zeitstempel und Zeitabstände

Numerische reset-Werte folgen verbreiteten Konventionen. Werte ab einer Milliarde gelten als Unix-Sekunden; ab hundert Milliarden werden sie als Unix-Millisekunden gelesen und umgerechnet. Kleinere nicht negative Zahlen werden als Abstand zu current_time addiert. Dadurch sind 30 oder 900 Wartezeiten, während heutige Epoch-Zeitstempel absolut bleiben. reset akzeptiert außerdem strikte UTC-Angaben wie 2026-07-25T12:01:00Z nach ISO 8601, optional mit Millisekunden. Das UTC-Suffix verhindert Zeitzonenannahmen. current_time unterstützt dieselben absoluten Formate, wird aber nie als Abstand behandelt. Die Prüfung erkennt unmögliche Daten, ungültige Uhrzeiten, fehlende Werte, negative Zahlen und fremden Text. Ein unlesbarer reset löst einen Eingabefehler aus und wird nicht unbemerkt zu null, denn eine versehentliche sofortige Wiederholung kann die Drosselung verschärfen und einen Ausfall verlängern.

Nutzen Sie deterministische Ergebnisse in Clients und Tests

Eine Wiederholungsrichtlinie sollte Auswertung und Entscheidung trennen. Ermitteln Sie mit dieser Funktion die Kontingentdaten und lassen Sie Ihre Anwendung anschließend warten, Aufgaben einreihen, Parallelität senken oder einen Hinweis anzeigen. current_time wird bewusst vorgegeben: Systemuhr, Netzwerk, Gebietsschema und Zufall können die Antwort nicht verändern. Daher stimmt die Browserberechnung mit der API überein und Regressionstests bleiben langfristig stabil. Ein Abstand von 60 bei genau zwölf Uhr ergibt stets einen eine Minute späteren Zeitstempel und sechzig verbleibende Sekunden. Frühere Rücksetzungen ergeben null, was bei verspäteten Webhooks oder archivierten Protokollen hilft. Das Tool errät keine anbieterspezifischen Header und bestimmt kein exponentielles Backoff. Es verarbeitet bereits extrahierte Standardwerte. Die Browserversion ist kostenlos; automatisierte API-Aufrufe kosten den angezeigten Grundpreis von $0.002 je Element.

Sichere Wiederholung planen

Wandeln Sie Header-Zeichenfolgen in eine ganzzahlige Verzögerung um, bevor Arbeit erneut eingereiht wird.

Anbieterdrosselung untersuchen

Normalisieren Sie erfasste Header und vergleichen Sie die Rücksetzung mit dem genauen Antwortzeitpunkt.

Deterministische Retry-Tests erstellen

Geben Sie eine feste Zeit vor und prüfen Sie stabile Berechnungen ohne simulierte Systemuhr.

Was kostet ein API-Aufruf?

Jedes Element nutzt den angegebenen Grundpreis von $0.002; das Browsertool führt dieselbe Berechnung lokal aus.

Welche Rücksetzformate werden unterstützt?

Verwenden Sie nicht negative Sekundenabstände, Unix-Zeitstempel in Sekunden oder Millisekunden oder strikte UTC-Angaben nach ISO 8601 mit Z.

Warum muss ich current_time angeben?

Eine ausdrückliche Zeit macht die Berechnung deterministisch und in Clients sowie Tests reproduzierbar.

Was geschieht bei einer vergangenen Rücksetzung?

seconds_until_reset wird auf null begrenzt, während reset_at_unix den ausgewerteten absoluten Zeitpunkt behält.

Sendet das Tool eine Anfrage oder wartet es?

Nein. Es prüft und normalisiert nur Ihre Werte; Wiederholungs- und Backoff-Entscheidungen bleiben Aufgabe Ihrer Anwendung.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/security/rate-limit-header-parse

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/security/rate-limit-header-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"100","remaining":"42","reset":"60","current_time":"2026-07-25T12:00:00Z"}'
{
  "limit": "100",
  "remaining": "42",
  "reset": "60",
  "current_time": "2026-07-25T12:00:00Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "security.rate_limit_header_parse",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →