Zum Inhalt springen

Glossar

Produkt & Engineering

Idempotenz

Idempotenz ist die Eigenschaft einer Operation, dieselbe Wirkung zu haben, egal ob sie einmal oder mehrmals ausgeführt wird. So kann eine Anfrage nach einem Timeout sicher wiederholt werden, ohne dass zum Beispiel ein Kunde doppelt belastet wird.

Aktualisiert am · Vom VIZIO AI Team

Was ist Idempotenz?

Eine idempotente Operation kann wiederholt werden, ohne das Ergebnis nach der ersten Ausführung zu ändern. „Setze den Bestellstatus auf versendet“ ist idempotent: Auch nach zwei Ausführungen ist der Status versendet. „Addiere 10 $ zum Guthaben“ ist es nicht: Zwei Ausführungen addieren 20 $.

Das ist wichtig, weil Netzwerke ausfallen. Ein Client kann oft nicht erkennen, ob eine Anfrage fehlgeschlagen ist oder nur die Antwort verloren ging. Ist die Operation idempotent, kann der Client sie einfach wiederholen.

Bei HTTP definiert RFC 9110 PUT, DELETE und die sicheren Methoden (GET, HEAD, OPTIONS und TRACE) als idempotent. POST ist es nicht, und deshalb ergänzen Zahlungs- und Bestell-APIs Idempotency Keys.

Wie funktionieren Idempotency Keys?

Der Client sendet einen eindeutigen Schlüssel mit einer Anfrage; der Server speichert das erste Ergebnis für diesen Schlüssel und gibt es bei jeder Wiederholung erneut zurück. Die Stripe-API ist eine gängige Referenz:

  • Der Client sendet einen Idempotency-Key-Header. Stripe empfiehlt V4-UUIDs, und Schlüssel können bis zu 255 Zeichen lang sein.

  • Bei API v1 speichert Stripe Statuscode und Body der ersten Anfrage, sobald der Endpunkt mit der Ausführung beginnt, und gibt diese gespeicherte Antwort bei Wiederholungen zurück, auch bei 500-Fehlern.

  • Kommt derselbe Schlüssel mit anderen Parametern an, gibt Stripe einen Fehler zurück.

  • Schlüssel können entfernt werden, sobald sie mindestens 24 Stunden alt sind; ein danach wiederverwendeter Schlüssel startet eine neue Anfrage.

  • Alle POST-Anfragen akzeptieren Schlüssel. GET und DELETE brauchen keine, weil sie per Definition idempotent sind.

Weitere Muster sind Unique Constraints in der Datenbank, Upserts statt Inserts und das Speichern verarbeiteter Ereignis-IDs beim Verarbeiten von Webhooks oder Queue-Nachrichten.

Wie sieht Idempotenz in der Praxis aus?

Machen Sie jeden Schritt, der Geld bewegt oder Datensätze anlegt, sicher gegen doppelte Ausführung. Stellen Sie sich einen Onlineshop vor, bei dem der Zahlungsschritt manchmal in einen Timeout läuft, nachdem der Kunde auf Bezahlen geklickt hat.

  1. Beim Start des Checkouts erzeugt der Server einen Schlüssel für diesen Warenkorb, etwa eine UUID, die mit dem Bestellentwurf gespeichert wird.

  2. Die Zahlungsanfrage an den Anbieter enthält diesen Schlüssel. Nach einem Timeout wiederholt der Server sie mit demselben Schlüssel.

  3. Die Bestelltabelle hat einen Unique Constraint auf der Zahlungs-ID, sodass ein zweites Ereignis „Zahlung erfolgreich“ keine zweite Bestellung anlegen kann.

  4. Der Webhook-Handler speichert jede verarbeitete Ereignis-ID und überspringt Wiederholungen.

Angenommen, der Kunde klickt doppelt und das Netzwerk verliert eine Antwort. Der Kunde wird einmal belastet und erhält eine Bestellbestätigung.

Welche typischen Fehler gibt es bei der Idempotenz?

Die meisten Idempotenzfehler entstehen durch Schlüssel, die im falschen Moment erzeugt oder an der falschen Stelle geprüft werden.

  • Neuer Schlüssel pro Wiederholung: Wer bei jedem Versuch einen neuen Schlüssel erzeugt, verfehlt den Zweck.

  • Ein Schlüssel für verschiedene Aktionen: Zwei verschiedene Zahlungen mit demselben Schlüssel werden abgelehnt oder zusammengeführt.

  • Race Conditions: Zwei identische Anfragen, die gleichzeitig eintreffen, können beide eine Prüfung „Habe ich das schon gesehen?“ bestehen, außer Prüfung und Schreibvorgang sind atomar, zum Beispiel durch einen Unique Constraint.

  • Nebenwirkungen zuerst: Eine E-Mail, die vor der Duplikatprüfung versendet wird, geht trotzdem zweimal raus.

  • Sensible Schlüssel: Stripe rät davon ab, E-Mail-Adressen oder andere personenbezogene Kennungen als Schlüssel zu verwenden.

  • Ablauf: Wiederholungen, die nach dem Entfernen eines Schlüssels eintreffen, laufen als neue Anfragen.

Worin unterscheidet sich Idempotenz von Deduplizierung und Exactly-once-Zustellung?

Deduplizierung verwirft wiederholte Nachrichten; Idempotenz macht die Operation selbst sicher wiederholbar. Wiederholungen bedeuten, dass dieselbe Nachricht zweimal ankommen kann, daher sollten Empfänger mit Duplikaten rechnen. Deduplizierung filtert sie heraus, meist anhand einer ID innerhalb eines Zeitfensters.

Exactly-once-Zustellung über ein Netzwerk lässt sich schwer garantieren. Systeme erreichen in der Praxis dasselbe Ergebnis meist durch die Kombination von Wiederholungen mit idempotenten Handlern.

Das Prinzip gilt auch für Daten. Ein erneut ausgeführter ETL-Job sollte die Daten eines Tages überschreiben, nicht doppelt anhängen. In einem agentischen Workflow kann ein KI-Agent einen Tool-Aufruf wiederholen, daher brauchen Tools, die Daten schreiben, denselben Schutz. Idempotenz ist eine Grundvoraussetzung zuverlässiger API-Integration.

Idempotente vs. nicht idempotente Operationen

Idempotent

Nicht idempotent

Beispiel

Status auf versendet setzen

10 $ zu einem Guthaben addieren

HTTP-Methoden

GET, HEAD, OPTIONS, TRACE, PUT, DELETE

POST, sofern nicht durch einen Schlüssel geschützt

Sicher wiederholbar

Ja

Nur mit Schlüssel oder Deduplizierung

Typische Absicherung

Korrektes Design reicht aus

Idempotency Keys, Unique Constraints

Risiko bei Wiederholung

Keines

Doppelte Datensätze oder doppelte Belastungen

Wie geht Vizio AI an Idempotenz heran?

Die veröffentlichten Fallstudien von Vizio AI beschreiben Arbeit an Idempotenz nicht im Detail. Sie ist eine Designregel, die für jede Integration, jeden Zahlungsablauf und jede Datenpipeline gilt.

Ihr erster Schritt: Listen Sie jeden Endpunkt und jeden geplanten Job auf, der Datensätze anlegt oder Geld bewegt, und prüfen Sie, was passiert, wenn er zweimal läuft.

Facebook-Logo
X-Logo
LinkedIn-Logo
Reddit-Logo
Telegram-Logo

AI-first denken.
Zukunftsschnell handeln.

Lassen Sie uns bauen, was als Nächstes kommt! Von Produktideen und intelligenten Workflows bis zu datengetriebenen Systemen und skalierbaren Growth Operations.

Strategiegespräch buchen