Grundlagen

Anträge idempotent anlegen

Ein Idempotency-Key verhindert doppelte Ressourcen bei wiederholten Anlage-Requests.

Ein Schlüssel pro neuer Ressource

Erzeugen Sie den Schlüssel, bevor Sie den ersten Anlageversuch senden, und speichern Sie ihn zusammen mit Ihrer externen Referenz. Bei einem Timeout wird exakt derselbe Schlüssel mit exakt demselben Body wiederverwendet.

Ein neuer Schlüssel erzeugt eine neue Ressource. Verwenden Sie keinen Zeitstempel, der sich bei jedem Retry ändert.

Empfohlenes Format

8 bis 255 druckbare ASCII-Zeichen ohne Leerzeichen.
Zum Beispiel UUID v4 oder eine kollisionsfreie Kombination aus eigener Auftrags-ID und Operation.
Keine personenbezogenen Daten oder vollständigen Fahrzeugdaten in den Schlüssel schreiben.

Idempotency-Key: order-84721-application-v1

Wiederholung und Konflikt

Situation	Erwartetes Verhalten
Gleicher Schlüssel, gleicher Body	Die ursprüngliche Anlage wird zurückgegeben; kein zweiter Antrag entsteht.
Gleicher Schlüssel, anderer Body	`409 idempotency_key_conflict`; Daten nicht automatisch erneut senden.
Neuer Schlüssel, gleicher Body	Neue Ressource wird angelegt.