Blog · 28. Oktober 2026 · 6 Min. Lesezeit

API-Integrationen, die nachts nicht ausfallen

Timeouts, doppelte Webhooks, halbe Datensätze: vier Muster, die eine Integration robust machen.

API-Integrationen, die nachts nicht ausfallen

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.

Ibrahim DoganSoftware Engineer & Consultant, Hamburg

Sie haben ein Projekt im Kopf?

Erzählen Sie mir kurz, worum es geht. Sie bekommen eine ehrliche Einschätzung und, wenn es passt, ein konkretes Angebot.

Projekt besprechen