Timeouts, Wiederholungen und Idempotenz verständlich planen, damit Schnittstellen nicht versehentlich doppelte Aufträge erzeugen.
Für wen ist das hilfreich? Entwicklungsteams und Prozessverantwortliche, die schreibende API-Aufrufe zuverlässig integrieren möchten.
Einsatzfälle und Einordnung
Ein Timeout sagt nicht sicher, ob ein Vorgang fehlgeschlagen ist. Der Server kann den Auftrag bereits gespeichert haben, während die Antwort auf dem Rückweg verloren geht. Wird derselbe Aufruf ungeprüft wiederholt, entstehen möglicherweise doppelte Bestellungen, Buchungen oder Benachrichtigungen.
Idempotenz bedeutet in diesem Zusammenhang, eine wiederholte fachliche Anfrage als denselben Vorgang zu erkennen. Dafür müssen Schlüssel, Gültigkeitsdauer und Nutzlast zusammenpassen. Eine zufällige neue Kennung bei jedem Wiederholversuch löst dieses Problem nicht.
Vorgehen im Detail
- Kritische Schreibvorgänge identifizieren. Für jeden Vorgang definieren, woran Gleichheit erkannt wird und welche Änderungen eine neue Anfrage darstellen.
- Eine stabile Vorgangskennung mit einer geprüften Nutzlast verknüpfen. Parallele Aufrufe, Konflikte und bereits gespeicherte Ergebnisse berücksichtigen.
- Fehlerfälle testen: verlorene Antwort, langsamer Server, doppelter Klick und geänderte Daten unter derselben Kennung. Einen klaren Statusabruf oder manuellen Klärungsweg vorsehen.
Ergebnisse auf einen Blick
- Definierte Bedeutung einer wiederholten Anfrage
- Schutz vor unbeabsichtigten Doppelaktionen
- Nachvollziehbarer Status bei unklarem Ausgang
- Begrenzte Wiederholungen mit dokumentierten Fehlerfällen
Gut vorbereitet entscheiden
Benötigt werden API-Verträge, typische Nutzlasten und die Liste irreversibler Nebenwirkungen. Unterscheiden Sie sichere Lesezugriffe von schreibenden Geschäftsaktionen.
Protokolle sollen Vorgänge korrelieren, aber keine Geheimnisse oder vollständigen sensiblen Nutzlasten offenlegen. Die Aufbewahrung von Idempotenzinformationen ist mit Prozesslaufzeit und Datenminimierung abzugleichen.
Fragen und Antworten
Darf ein Client nach jedem Fehler automatisch wiederholen?
Nein. Wiederholbarkeit hängt vom Endpunkt und vom Fehler ab. Ohne vereinbarte Idempotenz kann eine Wiederholung einen zweiten Geschäftsfall erzeugen.
Was wird bei gleichem Schlüssel und anderen Daten erwartet?
Ein klarer Konflikt ist meist sinnvoller als ein stilles Überschreiben. Die genaue Behandlung gehört in den Schnittstellenvertrag.