Skip to main content
Senden Sie bei jedem Request-Versuch eine UUID v4 oder v7 in X-Request-ID.
Wird der Header gesendet, gibt die API die ID unverändert zurück. Fehlt er, erzeugt JobHandy eine ID und liefert sie in der Response.

​
Zweck

Eine Request-ID verknüpft:
  • den Client-Versuch
  • die API-Response
  • Kundenlogs und Metriken
  • JobHandy-Diagnosedaten
  • einen Supportfall

​
Validierung

Der Wert muss eine UUID v4 oder v7 sein. Ungültige Werte schlagen mit INVALID_REQUEST_ID fehl.

​
Ein Versuch, eine Request-ID

Erzeugen Sie für jeden HTTP-Versuch eine neue Request-ID. Verknüpfen Sie Retries in Ihrer eigenen Telemetrie über eine interne ID der logischen Operation.

​
Kein Idempotency Key

X-Request-ID:
  • dedupliziert keine Anfragen
  • garantiert keine Exactly-once-Ausführung
  • macht POST- oder Statusübergangs-Anfragen nicht sicher wiederholbar
  • beweist nicht, dass ein Write nach einem Timeout nicht angewendet wurde
Lesen Sie nach einem mehrdeutigen Ergebnis eines Schreibvorgangs die betroffene Ressource erneut, bevor Sie entscheiden, ob ein weiterer Schreibvorgang erforderlich ist.

​
Logging-Empfehlung

Protokollieren Sie:
  • UTC-Zeitstempel
  • Methode und Pfadtemplate
  • Tenant-Kontext
  • HTTP-Status
  • API-Fehlercode
  • Request-ID
  • Nummer des Retry-Versuchs
  • interne ID der logischen Operation
Protokollieren Sie weder den API-Key noch unnötige personenbezogene Payload-Daten.
Zuletzt geändert am 28. August 2026