Unified API Update: Verbesserte Idempotenz-Handhabung
Im Kern jeder robusten API-Integration steht die Idempotenz – ein Mechanismus, der sicherstellt, dass eine wiederholte Anfrage keine unbeabsichtigten Nebeneffekte erzeugt.
Um mehr Transparenz darüber zu bieten, wie Ihre Anfragen verarbeitet werden, haben wir eine kleine, aber wirkungsvolle Erweiterung unserer Antwort-Header eingeführt.
Dieses Update gilt für alle Dienste, die auf der Unified API basieren – derzeit SIGN IT, SIGN FR und E-INVOICE.
Die Herausforderung: „War das eine Wiederholung?”
Abschnitt betitelt „Die Herausforderung: „War das eine Wiederholung?”“Wenn eine Anfrage mit demselben X-Idempotency-Key wiederholt wird, gibt unsere API korrekt die zwischengespeicherte Antwort des ursprünglichen Vorgangs zurück. Dieses Verhalten verhindert doppelte Verarbeitung und ist grundlegend für zuverlässige Integrationen.
Dies kann das Debugging jedoch erschweren. In bestimmten Situationen – insbesondere bei der Untersuchung von Grenzfällen – ist es möglicherweise nicht sofort ersichtlich, ob eine Antwort frisch generiert oder aus dem Idempotenz-Cache geliefert wurde.
Die Lösung: X-Idempotency-Replayed
Abschnitt betitelt „Die Lösung: X-Idempotency-Replayed“Mit dem neuesten Unified API-Release vom 18. März 2026 enthalten alle POST- und PATCH-Antworten einen neuen Header: X-Idempotency-Replayed.
Dieser Header gibt explizit an, ob eine Antwort aus dem Idempotenz-Cache wiedergegeben wurde:
X-Idempotency-Replayed: "true"
Die Anfrage wurde als Wiederholung erkannt, und die Antwort wurde aus dem Cache zurückgegeben.
X-Idempotency-Replayed: "false"
Die Anfrage wurde als neuer Vorgang verarbeitet, und die Antwort wurde normal generiert.
Mit diesem Update wird das Idempotenz-Verhalten transparenter – es verkürzt die Debugging-Zeit und hilft Ihnen, zuverlässigere Integrationen zu entwickeln.
Was this page helpful?