Ein Lichtschalter mit den Stellungen „an“ und „aus“ ist idempotent: Wer zweimal auf „an“ drückt, hat danach dasselbe Licht wie nach einmal Drücken. Ein Taster, der bei jedem Druck umschaltet, ist es nicht. Beim zweiten Druck geht das Licht wieder aus. In der Softwaretechnik ist dieser Unterschied keine Spitzfindigkeit. Er entscheidet, ob eine Automatisierung einen Fehler gefahrlos wiederholen kann oder ob sie dabei eine Rechnung doppelt anlegt.
Die maßgebliche Definition für Webschnittstellen steht in RFC 9110, der IETF-Norm zur Semantik von HTTP. Dort heißt eine Methode idempotent, wenn die beabsichtigte Wirkung mehrerer identischer Anfragen auf dem Server dieselbe ist wie die einer einzelnen. Zu den idempotenten Methoden zählt die Norm PUT, DELETE und die lesenden Methoden wie GET. POST, mit dem in den meisten APIs neue Datensätze angelegt werden, gehört nicht dazu.
Das Problem, das Idempotenz löst
Eine Automatisierung schickt eine Anfrage an das ERP: „Lege diesen Auftrag an.“ Dann bricht die Verbindung ab, bevor die Antwort ankommt. Was jetzt? Vielleicht hat das ERP die Anfrage nie erhalten. Vielleicht hat es den Auftrag angelegt, und nur die Bestätigung ging verloren. Von außen ist das nicht zu unterscheiden.
Wer nicht wiederholt, riskiert einen verlorenen Auftrag. Wer wiederholt, riskiert einen doppelten. RFC 9110 zieht daraus eine klare Folgerung: Idempotente Anfragen dürfen nach einem Kommunikationsfehler automatisch wiederholt werden, weil die Wiederholung dieselbe Wirkung hat, selbst wenn der erste Versuch erfolgreich war. Eine nicht idempotente Anfrage soll ein Client dagegen nicht automatisch wiederholen, es sei denn, er hat ein Mittel, um zu wissen, dass sie tatsächlich idempotent ist oder dass der erste Versuch nie angekommen ist.
Dasselbe Problem tritt in umgekehrter Richtung auf. Ein Webhook, dessen Zustellung der Absender für gescheitert hält, kommt ein zweites Mal. Eine Nachricht in einer Message Queue wird nach einem Absturz des Empfängers erneut zugestellt. Microsoft hält im Azure Architecture Center fest, dass die meisten Nachrichtensysteme Nachrichten mindestens einmal zustellen und damit dieselbe Nachricht mehr als einmal liefern können. Doppelte Zustellung ist also kein Ausnahmefall, sondern eingebaut.
Zwei Wege zur Idempotenz
Die Operation selbst so formulieren, dass sie wiederholbar ist. „Setze den Status von Auftrag 4711 auf versendet“ ist idempotent. „Erhöhe den Lagerbestand um zehn“ ist es nicht, „Setze den Lagerbestand auf 130“ dagegen schon. Ein Datensatz, der anhand eines fachlichen Schlüssels angelegt oder, falls schon vorhanden, aktualisiert wird, entsteht auch bei drei Versuchen nur einmal. Microsoft empfiehlt, wo immer möglich auf solche von Natur aus idempotenten Operationen zu setzen und Buchführung über verarbeitete Nachrichten nur dort einzubauen, wo das nicht geht.
Wiederholungen erkennen und aussortieren. Wo eine Operation von Natur aus etwas Neues erzeugt, eine Zahlung, eine E-Mail, einen Beleg, braucht jede Anfrage eine eindeutige Kennung. Der Empfänger merkt sich, welche Kennungen er schon verarbeitet hat, und behandelt eine bekannte Kennung als Wiederholung. Hohpe und Woolf beschreiben dieses Muster in den „Enterprise Integration Patterns“ als idempotenten Empfänger.
Der Idempotency Key
Für Web-APIs hat sich dafür ein Kopffeld namens Idempotency-Key eingebürgert.
Der aufrufende Client erzeugt für jeden fachlichen Vorgang einen zufälligen,
eindeutigen Wert und schickt ihn mit. Kommt dieselbe Anfrage mit demselben
Schlüssel noch einmal, führt der Server sie nicht erneut aus, sondern liefert
das Ergebnis des ersten Versuchs.
Der Zahlungsdienstleister Stripe beschreibt die Umsetzung in seiner Dokumentation konkret: Er speichert Statuscode und Antwort der ersten Anfrage zu einem Schlüssel, gleich ob sie erfolgreich war oder nicht, und gibt bei Wiederholungen genau dieses Ergebnis zurück. Weichen die Parameter einer späteren Anfrage mit demselben Schlüssel ab, meldet er einen Fehler. Schlüssel können nach frühestens 24 Stunden gelöscht werden; danach gilt eine Wiederholung als neue Anfrage. Stripe rät außerdem davon ab, sensible Daten wie E-Mail-Adressen als Schlüssel zu verwenden.
In der IETF gibt es einen Entwurf, der dieses Kopffeld einheitlich festlegen soll. Er empfiehlt eine UUID als Schlüssel und beschreibt, wie ein Server reagieren soll: mit dem gespeicherten Ergebnis bei einer Wiederholung, mit Status 409, wenn die erste Anfrage noch in Bearbeitung ist, und mit Status 422, wenn derselbe Schlüssel mit anderem Inhalt kommt. Zum Stand: Die letzte Fassung (Version 07) stammt vom Oktober 2025 und ist laut IETF-Datatracker im April 2026 ausgelaufen. Ein verabschiedeter Standard ist das Kopffeld damit nicht (Stand Oktober 2026). In der Praxis heißt das: Ob und wie eine API Idempotenzschlüssel unterstützt, steht in ihrer Dokumentation, nicht in einer Norm.
Woran Umsetzungen scheitern
Die Kennung ändert sich bei jedem Versuch. Wer den Schlüssel aus einem Zeitstempel oder einer Zustellnummer bildet, die das System bei jeder Wiederholung neu vergibt, erkennt nie eine Doppelung. Microsoft rät, eine vom Absender vergebene Nachrichtenkennung oder einen fachlichen Schlüssel zu verwenden, etwa die Bestellnummer.
Prüfen und Ausführen sind getrennt. Die Automatisierung legt den Auftrag an, stürzt ab und kommt nicht mehr dazu, die Kennung zu speichern. Beim nächsten Versuch fehlt die Kennung, und der Auftrag entsteht doppelt. Kennung und Wirkung gehören deshalb in denselben Speichervorgang. Bei Wirkungen außerhalb der eigenen Datenbank, einer Zahlung über einen Dienstleister oder einer verschickten E-Mail, beschreibt Microsoft einen Zwischenstand „in Bearbeitung“, der bei einer Wiederholung zur Prüfung statt zur erneuten Ausführung führt.
Die Kennungen werden zu früh vergessen. Wer verarbeitete Kennungen nach einer Stunde löscht, ist gegen eine Wiederholung nach zwei Stunden nicht geschützt. Die Aufbewahrung muss mindestens so lang sein wie der Zeitraum, in dem Wiederholungen kommen können, einschließlich Nachrichten, die jemand nach einer Störung aus der Ablage für Fehlschläge von Hand erneut einspielt.
Idempotenz in KI-Abläufen
Ein Sprachmodell liefert bei gleicher Eingabe nicht zwingend dieselbe Antwort. Für die Idempotenz ist das unerheblich, solange das Modell nur liest und vorschlägt. Heikel wird es, wenn das Modell über Function Calling Aktionen auslöst. Ein KI-Agent, der nach einem Zeitüberschreiten seinen letzten Schritt wiederholt, legt ohne Vorkehrung ein zweites Ticket an oder schickt dem Kunden die zweite Mail. Jede Funktion, die ein Modell aufrufen darf und die etwas verändert, sollte deshalb einen Schlüssel annehmen, der aus dem Vorgang abgeleitet ist und nicht aus dem einzelnen Modellaufruf.
Für die Planung einer Automatisierung genügen meist drei Fragen je schreibendem Schritt: Was passiert, wenn dieser Schritt zweimal läuft? Unterstützt das Zielsystem Idempotenzschlüssel oder ein Anlegen-oder-Aktualisieren über einen fachlichen Schlüssel? Und wo wird festgehalten, was schon erledigt ist? Wer diese Fragen beantwortet hat, kann Wiederholungen bei vorübergehenden Störungen großzügig zulassen. Wer nicht, sollte gar nicht automatisch wiederholen und jeden Fehlschlag in die Ausnahmebehandlung geben.
Quellen
- RFC 9110: HTTP Semantics, Abschnitt 9.2.2 Idempotent Methods, Internet Engineering Task Force (IETF), 2022
- The Idempotency-Key HTTP Header Field (Internet-Draft, Version 07), IETF, Arbeitsgruppe httpapi, 2025
- Idempotent requests, Stripe API Reference
- Idempotent Consumer pattern, Microsoft Learn, Azure Architecture Center
- Idempotent Receiver, Gregor Hohpe, Bobby Woolf: Enterprise Integration Patterns
Inhaltlich geprüft im Oktober 2026. Der Eintrag erklärt einen Begriff und ersetzt keine Rechts- oder Steuerberatung.

