Idempotenz
Wiederhole Schreibaufrufe ohne doppelte Ausführung.
Alle schreibenden Operationen benötigen Idempotency-Key mit 1 bis 200 Zeichen. Erzeuge eine UUID pro beabsichtigter Änderung. Behalte bei Netzwerkfehlern dieselbe UUID und denselben Inhalt bei.
Ein identischer Aufruf liefert das gespeicherte Ergebnis und Idempotent-Replayed: true. Derselbe Schlüssel mit einem anderen Inhalt oder einer anderen Operation liefert 422 idempotency_key_reused. Ein fehlender Header liefert 400 idempotency_key_required.
Der Gültigkeitsbereich ist Tenant und Benutzer. Zwei API-Schlüssel desselben Benutzers teilen daher denselben Idempotenzbereich. Bewahre Schlüssel und Anfrage für mindestens 24 Stunden auf.
Leseaufrufe brauchen keinen Idempotency-Key. Das gilt auch für POST-Suchen, Validierungen und Bulk-Downloads, wenn die Referenz die Operation als lesend ausweist.