Idempotenz
AllePOST- und PATCH-Mutation-Endpunkte akzeptieren einen optionalen Idempotency-Key-Header.
Wann du ihn senden solltest
Verwende einen Idempotency-Key, wenn:- Ein Client nach einem Transportfehler erneut versuchen könnte.
- Ein Queue-Worker denselben logischen Vorgang mehr als einmal ausführen könnte.
- Ein KI-Agent eine Mutation nach teilweisem Fortschritt oder Tool-Retries erneut ausführen könnte.
Empfohlenes Muster
- Erzeuge einen stabilen Key pro logischer Mutation.
- Verwende für Wiederholungen dieser Mutation denselben Key erneut.
- Ändere den Key, wenn sich die beabsichtigte Mutation ändert.
Beispiele
Gute Abgrenzungen
- Ein Key zum Erstellen eines Projekts.
- Ein anderer Key zum Exportieren dieses Projekts.
- Wieder ein anderer Key zum Aktualisieren der Projekteinstellungen.