Zuverlässiger Betrieb
Wiederholungen einplanen.
Doppelte Arbeit vermeiden.
Verbindungsabbrüche und erneute Zustellungen gehören zu einer Integration. Entscheidend ist, dass daraus keine doppelten Vorgänge entstehen.
Ein Beispiel aus der Praxis
Deine Anwendung hat eine Buchung übermittelt, aber die Antwort geht verloren. Bevor sie einen neuen Vorgang anlegt, muss sie den bestehenden Auftrag wiedererkennen können.
Fachliche Referenzen stabil halten
Unsere REST-API erkennt beim Anlegen einer Buchung eine bereits vorhandene externalReference derselben Herkunft wieder und liefert die bestehende Buchung zurück. Verwende daher eine stabile Referenz für denselben Vorgang. Dieser Mechanismus aktualisiert keine bestehende Buchung und gilt nicht automatisch für jede API-Operation.
Ereignis und Zustellung unterscheiden
Eine erneute Webhook-Zustellung erhält eine neue Delivery-ID. Unsere Empfehlung: Erkenne bereits verarbeitete Ereignisse anhand der Event-ID wieder, statt allein auf die Zustellungs-ID zu vertrauen. So löst dieselbe Änderung nicht mehrfach dieselbe Folgeaktion aus.
Fehler gezielt behandeln
Unsere REST-API liefert strukturierte Fehler mit Fehlercode und traceId. Nutze diese Angaben für Diagnose und Support, ohne Zugangsdaten mitzuprotokollieren. Korrigiere ungültige Eingaben oder fehlende Rechte, bevor du erneut anfragst. Plane Wiederholungen bei vorübergehenden Störungen mit Abstand und einer klaren Grenze.