
Eine Integration zwischen zwei Systemen ist schnell gebaut. Sie so zu bauen, dass sie auch dann funktioniert, wenn das andere System langsam ist, doppelt sendet oder kurz ausfällt, ist die eigentliche Arbeit. Aus Jahren mit Zahlungs- und Abrechnungssystemen sind das die vier Muster, die ich immer einsetze.
1. Idempotenz
Jede Anfrage, die etwas verändert, bekommt einen eindeutigen Schlüssel. Kommt dieselbe Anfrage zweimal, etwa weil ein Webhook wiederholt wird, passiert die Aktion trotzdem nur einmal. Ohne das entstehen doppelte Rechnungen.
2. Wiederholungen mit Bedacht
Fehlgeschlagene Aufrufe werden automatisch wiederholt, aber mit wachsendem Abstand und einer Obergrenze. Sonst verwandelt sich ein kurzer Ausfall beim Partner in einen selbstgebauten Lastangriff.
3. Warteschlangen statt direkter Kopplung
Eingehende Ereignisse landen zuerst in einer Queue und werden dann verarbeitet. Fällt die Verarbeitung aus, geht nichts verloren; Nachrichten, die dauerhaft scheitern, landen in einer separaten Ablage und lösen einen Alarm aus.
4. Eine Übersetzungsschicht
Das Datenmodell des Partners gehört nicht in den Kern Ihrer Anwendung. Eine kleine Schicht übersetzt zwischen beiden Welten. Ändert der Anbieter seine API, muss nur diese Schicht angepasst werden.
Und dann: beobachten
Strukturierte Logs, eine Korrelations-ID pro Vorgang und Alarme für Fehlerquoten statt für jeden Einzelfehler. So weiß man morgens, was nachts passiert ist, und nicht erst, wenn ein Kunde anruft.