API-Integration ohne Insellösungen: Mehrere Systeme über REST-API verbinden

Eine API-Integration verhindert Insellösungen nur, wenn die Schnittstellen von Anfang an für das ganze System entworfen werden und nicht als Punkt-zu-Punkt-Verbindung für den nächsten Anlass. Für IT-Leitungen, die eine gewachsene Landschaft ohne eigenes Entwicklungsteam verantworten, entscheidet dieses Design darüber, ob jedes neue System die Wartung vergrößert oder verkleinert.

Warum Insellösungen trotz Schnittstellen entstehen

Fast jedes System hat heute eine API. Inseln entstehen trotzdem, weil jede Verbindung einzeln gebaut wird: das ERP direkt an die Sendungsverfolgung, die Sendungsverfolgung direkt an den Shop, der Shop direkt an die Buchhaltung. Jede dieser Verbindungen ist für sich einfach. Zusammen bilden sie ein Geflecht, in dem jede Änderung an einem System drei andere trifft und niemand mehr weiß, welche.

Der Gegenentwurf ist lose Kopplung. Jede Schnittstelle ist ein eigenständiger Dienst mit dokumentiertem Verhalten, und die Systeme sprechen über eine gemeinsame Schicht miteinander, nicht direkt. Ein Logistiker, der eine neue Sendungsverfolgung anbindet, hängt sie an diese Schicht. Das ERP merkt vom Wechsel nichts.

Mehrere Systeme über REST-API verbinden: fünf Regeln für das Design

Erst die Spezifikation, dann der Code

Bevor eine Zeile Code entsteht, wird die Schnittstelle beschrieben, maschinenlesbar in OpenAPI: Endpunkte, Datenformate, Fehlerfälle. Diese Beschreibung ist die verbindliche Absprache zwischen allen Beteiligten, auch mit externen Anbietern. Wer sie vor dem Bau erzwingt, erspart sich die Diskussion nach dem Bau, wer das Feld nun wie gemeint hat.

Offene Protokolle und Formate

REST mit JSON ist der Standard, den jedes moderne System versteht; für Verbindungen mit hohem Durchsatz zwischen eigenen Diensten kommt gRPC in Frage. Herstellereigene Formate, die nur ein Anbieter lesen kann, gehören nicht in die Integrationsschicht. Sie sind der schnellste Weg in die Abhängigkeit, die Sie gerade abbauen wollen.

Versionierung und Rückwärtskompatibilität

Jede Schnittstelle trägt von Anfang an eine Versionsnummer im Pfad. Neue Felder kommen optional dazu, alte werden als auslaufend markiert und erst entfernt, wenn kein Client sie mehr nutzt. Alte Clients laufen auf der alten Version weiter, neue nutzen die erweiterte. So bleibt der Betrieb stabil, während sich die Landschaft verändert.

Sicherheit im Entwurf

Authentifizierung über OAuth und OpenID Connect, rollenbasierte Berechtigungen, Verschlüsselung auf dem Transportweg und ein Protokoll jedes Zugriffs gehören in die Spezifikation, nicht in ein späteres Ticket. Jeder Client bekommt genau die Rechte, die seine Aufgabe braucht. Für Unternehmen unter der DSGVO ist das Zugriffsprotokoll zugleich der Nachweis, wer welche Daten wann gelesen hat.

Überwachung und Fehlerbehandlung

Ein einheitliches Fehlerformat über alle Schnittstellen, Kennzahlen zu Antwortzeiten und Fehlerraten und ein Alarm, wenn eine Rate steigt. Ohne diese Überwachung erfahren Sie von einem Schnittstellenproblem, wenn der Kunde anruft.

Vom Flickenteppich zur Plattform

Der typische Ausgangspunkt: fünf Systeme, die nicht miteinander sprechen, verbunden durch Exporte und Abtippen. Der Umbau beginnt mit einer Bestandsaufnahme aller Datenflüsse und Handarbeitsstellen. Dann kommt die Integrationsschicht: ein API-Gateway, das die Daten aller Systeme über dokumentierte REST-Schnittstellen bereitstellt, und ein Nachrichtensystem für Ereignisse wie „Auftrag angelegt“. System für System wird angebunden, die Handarbeit dazwischen fällt weg, und neue Systeme docken an die Schicht an statt an jedes andere System.

Was dabei entsteht, ist keine weitere Software, sondern das Rückgrat, an dem alles Weitere hängt, einschließlich eines späteren KI-Assistenten, der über dieselben Schnittstellen auf Aufträge und Bestände zugreift.

Was ein Umsetzungspartner dafür mitbringen muss

Eine Integrationsschicht, die niemand betreibt, wird die nächste Insel. Deshalb reicht es nicht, dass ein Partner Schnittstellen entwerfen kann. Er muss sie bauen, mit Überwachung betreiben und bei einem Fehler in verbindlicher Zeit reagieren. Fragen Sie nach laufenden Integrationen, nicht nach Konzepten, und nach einem Wartungsvertrag mit Reaktionszeiten. Wenn wir bei dataso für eine Landschaft nicht die Richtigen sind, sagen wir Ihnen das im ersten Gespräch.

Häufige Fragen zur API-Integration

Was unterscheidet eine API-Integration von einer Insellösung? Eine Integration verbindet Systeme über dokumentierte Schnittstellen, sodass Daten ohne Handarbeit fließen und eine Änderung an einem System die anderen nicht bricht. Eine Insellösung läuft für sich und wird per Export oder Abtippen mit dem Rest verbunden.

Wie bleiben Sie unabhängig vom Anbieter? Offene Standards in der Integrationsschicht, Container nach offenem Standard im Betrieb und ein Exportweg für alle Daten, der getestet ist.

Was kostet eine Integration? Das hängt von Zahl und Zustand der Systeme ab. Ein seriöser Partner nennt Ihnen nach der Bestandsaufnahme einen Preis pro Anbindung und einen Termin, an dem sie läuft.

Der nächste Schritt: Ihre Verbindungen zählen

Zeichnen Sie jede Verbindung zwischen Ihren Systemen auf ein Blatt, auch die per Export und Zwischenablage. Markieren Sie die ohne Dokumentation und ohne Verantwortlichen. Welche davon zuerst in eine Integrationsschicht gehört und was das kostet, klären wir mit Ihnen in einer halben Stunde: Potenzial-Check buchen.