API & Integrationen

Häufige Fehler bei Schnittstellen und Integrationen

Schnittstellenprojekte scheitern fast immer an der Annahme, die Gegenseite verhalte sich zuverlässig. Sie tut es nicht: Systeme sind in Wartung, antworten langsam, liefern unerwartete Formate oder brechen mitten in der Übertragung ab. Wer keine Wiederholungslogik und keine Protokollierung einbaut, merkt einen Ausfall erst, wenn Bestellungen fehlen — und kann dann nicht mehr rekonstruieren, welche. Zweiter Fehler: Zugangsdaten werden fest in den Code geschrieben. Spätestens beim ersten Wechsel des Dienstleisters oder beim ersten öffentlichen Repository ist das ein Sicherheitsvorfall. Schlüssel gehören in die Serverumgebung, nicht in die Versionsverwaltung. Drittens wird die Datenhoheit nicht geklärt: Welches System führt, wenn Shop und Warenwirtschaft unterschiedliche Bestände melden? Ohne diese Festlegung überschreiben sich beide Seiten abwechselnd, und niemand weiß, welcher Wert stimmt. Und viertens fehlt eine Testumgebung. Wer Schnittstellen direkt gegen das Produktivsystem entwickelt, verschickt im Zweifel echte Rechnungen an echte Kunden. Fünfter Punkt: Es wird nicht festgelegt, was bei Teilerfolgen passiert. Wenn von hundert Datensätzen achtzig übertragen werden und dann ein Fehler auftritt, muss klar sein, ob der Vorgang wiederholbar ist, ohne Dubletten zu erzeugen. Ohne eindeutige Kennungen je Vorgang ist das nicht möglich. Schnittstellen sind selten spektakulär, aber sie sind der Teil des Systems, der am zuverlässigsten Schaden anrichtet, wenn er unbeaufsichtigt läuft. Protokollierung und ein definierter Wiederanlauf gehören deshalb von Beginn an dazu, nicht nach dem ersten Zwischenfall.