API-Integration: die technische Brücke zwischen zwei Systemen, die nie füreinander gebaut wurden.
Wenn Standard-Konnektoren nicht reichen, entsteht die Verbindung selbst. Ich entwickle Schnittstellen und Integrationsschichten zwischen Ihren Systemen — mit definierter Authentifizierung, sauberem Umgang mit technischen Limits und einer Fehlerbehandlung, die aus einer Demo eine Produktionslösung macht.
- Nicht komplexer als nötig — aber robust genug für den echten Betrieb
- Wiederholung, Idempotenz und Protokollierung von Anfang an
- Neutraler, weit verbreiteter Standard-Stack, dokumentiert und übergebbar
- Sie entscheiden mit — die Begriffe werden vorher erklärt, nicht vorausgesetzt
„Dafür gibt es doch bestimmt eine fertige Verbindung.“
Manchmal stimmt das. Dann ist der fertige Konnektor die richtige Antwort und dieses Thema ist nach einer Stunde erledigt. Häufig aber deckt der Standard nur den halben Fall ab: Er kennt zwei Felder nicht, er ignoriert Ihre Ausnahmen, er läuft nur in eine Richtung, oder er scheitert daran, dass eines Ihrer Systeme älter ist als die Idee von Konnektoren.
Dann beginnt eine typische Zwischenphase: einzelne Automationen, eine Tabelle als Puffer, ein Skript auf einem Rechner, den nur eine Person kennt. Das funktioniert überraschend lange und wird genau dann zum Problem, wenn der Prozess geschäftskritisch geworden ist.
Der Unterschied zwischen einer Bastellösung und einer Schnittstelle liegt selten im Normalfall — der ist meist schnell gebaut. Er liegt im Verhalten bei Zeitüberschreitung, bei doppelten Nachrichten, bei einem Anbieterlimit oder bei einem System, das gerade eine Wartung fährt.
Genau diese Fälle sind der Grund, warum es diese Seite gibt. Sie sind kein Detail für später, sondern die Entscheidung darüber, ob die Verbindung in zwei Jahren noch läuft.
Vier Möglichkeiten — und woran sich die Entscheidung festmacht.
Es gibt keinen grundsätzlich besten Weg. Es gibt einen, der zu Ihrem Prozess, Ihrem Mengengerüst und Ihren Zuverlässigkeitsanforderungen passt. Die Entscheidung fällt nach der Prozessaufnahme, nicht vorher.
Direkte API-Anbindung
Zwei Systeme, ein klar umrissener Datenfluss, brauchbare Schnittstellen auf beiden Seiten. Die schlankeste Variante — richtig, solange die Logik dazwischen überschaubar bleibt und nicht ständig wächst.
Automatisierungsplattform
Schnell aufgebaut, gut sichtbar, ohne eigenen Betrieb. Sinnvoll bei überschaubaren Mengen und Standardfällen. Die Grenze liegt bei komplexer Geschäftslogik, vielen Ausnahmen und hohen Anforderungen an Nachvollziehbarkeit.
Eigene Integrationsschicht
Eine Stelle, an der Daten übersetzt, zwischengespeichert und wiederholt werden — statt fünf Automationen, die voneinander nichts wissen. Mehr Aufwand am Anfang, deutlich weniger Reibung im Betrieb.
Ereignisbasiert oder im geplanten Lauf
Entweder löst ein Vorgang unmittelbar aus, oder es läuft eine geplante Übertragung. Echtzeit dort, wo jemand wartet; zeitversetzt dort, wo es niemandem auffällt. Diese Trennung spart mehr als jede Werkzeugdiskussion.
Die fünf Begriffe, an denen sich Demo und Produktionslösung trennen.
Sie müssen davon nichts umsetzen können. Aber wenn Sie diese fünf Fragen einem Anbieter stellen, wissen Sie nach zehn Minuten, woran Sie sind.
Authentifizierung
Wie weist sich die Integration gegenüber dem anderen System aus, und wo liegen die Zugangsdaten? Technische Zugänge bekommen den kleinstmöglichen Rechteumfang und werden getrennt verwaltet — nie der persönliche Zugang einer Mitarbeiterin, die irgendwann das Unternehmen verlässt.
Ratenbegrenzung
Fast jeder Anbieter begrenzt, wie viele Anfragen pro Zeitraum erlaubt sind. Wer das ignoriert, baut eine Verbindung, die im Test läuft und am ersten vollen Arbeitstag blockiert wird. Diese Limits gehören zu den ersten Dingen, die geprüft werden.
Wiederholung
Wenn ein System kurz nicht antwortet, wird nicht abgebrochen, sondern nach einem definierten Muster erneut versucht — mit wachsenden Abständen, damit ein überlastetes System nicht zusätzlich unter Druck gerät. Erst danach greift der Fehlerpfad.
Idempotenz
Wenn eine Übertragung wiederholt wird, darf derselbe Vorgang nicht zweimal ankommen. Technisch heißt das: Jede Nachricht bekommt ein eindeutiges Merkmal, an dem die Gegenseite eine Wiederholung erkennt. Praktisch heißt es: keine doppelten Aufträge, keine doppelten Rechnungen.
Protokoll und Warnmeldung
Jede Übertragung hinterlässt eine Spur, jeder unlösbare Fehler eine Meldung an einer Stelle, die jemand im Haus beobachtet. Sie sollen nicht von einem Kunden erfahren, dass die Schnittstelle seit Dienstag steht.
Versionswechsel beim Anbieter
APIs ändern sich. Felder verschwinden, Authentifizierungsverfahren werden abgekündigt, Endpunkte bekommen eine neue Version. Wer die Verbindung nach dem Go-live nicht beobachtet, erfährt davon durch den Ausfall.
Von der Idee zur belastbaren Schnittstelle.
Sechs Schritte. Der Fehlerpfad entsteht dabei nicht am Ende, sondern parallel zum Normalfall — sonst wird er nie fertig.
- Schritt 01
Prozess und Datenfluss klären
Was soll übertragen werden, in welcher Richtung, wie oft, ausgelöst wodurch — und was ist die fachliche Konsequenz, wenn eine Übertragung ausfällt.
- Schritt 02
Schnittstellen beider Seiten prüfen
API, Webhooks, Authentifizierung, Datenmodell, Testumgebung, Ratenbegrenzungen und dokumentierte Eigenheiten. Ergebnis ist eine API-Matrix statt einer Vermutung.
- Schritt 03
Weg entscheiden
Direkte Anbindung, Plattform, eigene Integrationsschicht oder geplanter Lauf — begründet, mit Alternativen und den jeweiligen Konsequenzen für Aufwand und Betrieb.
- Schritt 04
Bauen mit Fehlerpfad
Umsetzung inklusive Wiederholung, Idempotenz, Protokollierung und Warnmeldungen. Der Fehlerpfad entsteht nicht am Ende, sondern parallel zum Normalfall.
- Schritt 05
Gegen Akzeptanzkriterien testen
Normalfall, Fehlerfälle, Grenzwerte, Mengengerüst. Getestet wird gegen vorher schriftlich festgelegte Kriterien, nicht gegen ein Bauchgefühl.
- Schritt 06
Produktivsetzung und Übergabe
Aktivierung nach Plan, Beobachtung der ersten Tage, technische Dokumentation und Übergabe von Code und Zugängen. Betrieb auf Wunsch in laufender Betreuung.
Wenn die Prüfung ergibt, dass ein fertiger Standard-Konnektor Ihren Fall vollständig abdeckt, sage ich das. Das ist dann die günstigere Antwort und ein kürzeres Projekt.
Wann eine eigene Schnittstelle der richtige Schritt ist — und wann nicht.
Das passt, wenn …
- Für Ihre Kombination aus Systemen gibt es keine fertige Verbindung oder sie deckt den Fall nur halb ab
- Zwischen den Systemen liegt echte Geschäftslogik mit Ausnahmen
- Der Prozess ist geschäftskritisch geworden und läuft trotzdem über Bastellösungen
- Bestehende Automationen brechen regelmäßig und niemand weiß zuverlässig, warum
- Es gibt auf beiden Seiten eine Schnittstelle oder zumindest einen geregelten Datenweg
Das passt eher nicht, wenn …
- Ein fertiger Standard-Konnektor deckt Ihren Fall vollständig ab — dann ist er die günstigere Antwort
- Es geht um eine einzelne, selten genutzte Übertragung mit geringem Wert
- Eines der beteiligten Systeme lässt Zugriffe technisch oder vertraglich nicht zu
- Erwartet wird eine Rund-um-die-Uhr-Reaktionszusage mit vertraglichen Reaktionszeiten
Die ehrlichste Antwort auf eine Integrationsfrage ist manchmal: Dafür gibt es bereits etwas. Diese Antwort bekommen Sie hier auch.
Was daneben liegt.
Schnittstellenentwicklung ist der technische Unterbau der übrigen Bausteine. Je nach Ausgangslage liegt der sinnvollere Einstieg woanders.
Der Überblick: Software-Implementierung
Wie Schnittstellenentwicklung in die Kette aus Prozess, Architektur, Umsetzung, Migration und Betrieb passt.
Anwendungsfall: CRM-Integration
Leads, Kunden und Angebote über Systemgrenzen — und die Systeme, mit denen ich belegbar arbeite.
Anwendungsfall: ERP-Integration
Die operative Datenbasis öffnen, ohne sie zu gefährden: Datenhoheit, Lese- und Schreibrechte, Taktung.
Wenn eine Oberfläche fehlt: Web-App-Entwicklung
Manchmal reicht die Schnittstelle nicht, weil niemand einen Ort hat, an dem er mit den Daten arbeiten kann.
Danach: Managed Integration
APIs ändern sich, Zugänge laufen aus. Monitoring und Reaktion auf Anbieteränderungen sind ein eigener Baustein.
Nur ein Ablauf? Workflow-Pilot
Wenn ein wiederkehrender Prozess mit vorhandenen Werkzeugen automatisiert werden kann, ist das der schnellere Weg.
Häufige Fragen zur API- und Schnittstellenentwicklung
Das hängt vor allem davon ab, wie viele Systeme beteiligt sind, wie gut ihre Schnittstellen dokumentiert sind, wie viel Geschäftslogik dazwischen liegt, wie viele Ausnahmen es gibt und wie hoch die Anforderungen an Zuverlässigkeit und Nachvollziehbarkeit sind. Deshalb steht auf dieser Seite bewusst kein Betrag: Eine Zahl ohne Kenntnis Ihrer Systeme wäre entweder zu hoch, weil ich Puffer einpreisen müsste, oder zu niedrig, und dann streiten wir später über den Umfang. Nach dem System- & Integrations-Check gibt es eine belastbare Größenordnung und ein schriftliches Angebot, bevor gebaut wird.
Welche zwei Systeme sollen bei Ihnen endlich direkt miteinander sprechen?
Im ersten Gespräch klären wir, welche Schnittstellen es auf beiden Seiten gibt, ob ein Standardweg ausreicht und welcher Aufwand realistisch dahintersteht. Wenn ein fertiger Konnektor Ihren Fall abdeckt, sage ich das — dann sparen wir beide die Zeit. 30 Minuten, unverbindlich.
Welche zwei Systeme sollen bei Ihnen direkt miteinander sprechen?
Zwei bis drei Sätze genügen. Im Erstgespräch klären wir, welche Schnittstellen auf beiden Seiten existieren, ob ein Standardweg ausreicht und welcher Aufwand realistisch dahintersteht. 30 Minuten, unverbindlich.
- Antwort innerhalb eines Werktags
- Keine Vertragsbindung durch die Anfrage
- Förder-Check inklusive
Lieber direkt Kontakt aufnehmen?