APIs als Architekturentscheidung

PIs verbinden CMS, CRM, ERP und Fachsysteme zu einer Plattform. Wer sie strategisch plant, baut Systeme, die Daten in Echtzeit teilen – ohne doppelte Pflege, ohne Medienbrüche, ohne Abhängigkeit von einem einzigen Dienstleister.

Was eine API von einem Plugin unterscheidet

Eine API (Application Programming Interface) ist eine definierte Schnittstelle zwischen zwei Systemen. Sie legt fest, welche Daten in welchem Format ausgetauscht werden und welche Operationen erlaubt sind. Im Plattform-Kontext ist eine API keine technische Beilage, sondern eine Architekturentscheidung – sie bestimmt, wie autonom ein Unternehmen seine Daten steuern kann.

Eine API ist kein Plugin. Ein Plugin erweitert ein System um Funktionen. Eine API verbindet Systeme miteinander, damit Daten zwischen ihnen fließen können – in beide Richtungen, in Echtzeit oder im Takt, mit klaren Regeln. Wer eine API in die Plattform einplant, entscheidet sich gegen Insellösungen und für eine Architektur, in der Daten dort entstehen, wo sie geführt werden, und dort genutzt werden, wo sie wirken.

In Data Enablement ist die API der operative Hebel – sie gehört zum Foundation Layer, dem Datenfundament, auf dem Auswertung, Dashboards und KI-Anwendungen aufsetzen. Datenmodelle und Reports funktionieren nur, wenn die Quellsysteme ihre Daten freigeben – und das tun sie über APIs.

Wie APIs Daten zwischen
Systemen austauschen

API-Integrationen folgen einer überschaubaren Anzahl von Architekturmustern. Wer die Muster kennt, kann Architekturentscheidungen begründen, statt sich vom Dienstleister überreden zu lassen.

REST, GraphQL, Webhooks
Drei Bauweisen für unterschiedliche Anwendungsfälle

REST

REST (Representational State Transfer) ist der Standard für die meisten Business-Integrationen. Das System holt sich aktiv Daten ab – etwa Immobilienobjekte aus einem CRM. REST ist robust, gut dokumentiert, von fast jedem System unterstützt – damit Daten dort gepflegt werden, wo sie entstehen, nicht doppelt.

GraphQL

GraphQL ist die Antwort auf das Problem, dass REST oft zu viele oder zu wenige Daten liefert. Mit GraphQL beschreibt das anfragende System exakt, welche Felder es braucht – das spart Bandbreite und Komplexität, lohnt sich aber erst bei größeren Datenmengen oder komplexen Frontends. Damit Oberflächen nicht durch unnötige Datenmengen langsam werden.

Webhooks

Webhooks drehen die Richtung um: Statt aktiv abzufragen, wartet ein System darauf, vom Quellsystem informiert zu werden – etwa wenn ein neues Objekt im CRM angelegt wurde. Webhooks sind die Voraussetzung für echte Echtzeit-Integration – damit eure Plattform nicht 50× pro Stunde nach Updates fragt, sondern automatisch informiert wird.

Zugriff und Entscheidung:
zwei getrennte Fragen

API-Sicherheit funktioniert über klar geregelte Zugangsverfahren: OAuth 2.0 (Open Authorization) für Drittanbieter-Integrationen, API-Keys für maschinelle Zugriffe, Token-basierte Verfahren für persönliche Logins. Jede Architekturentscheidung ist auch eine Sicherheitsentscheidung – und nachträglich nur schwer zu reparieren.

Synchron oder asynchron – Echtzeit ist nicht immer die Antwort

Synchrone API-Calls warten auf die Antwort – sinnvoll, wenn das Ergebnis sofort gebraucht wird (Fahrzeugsuche, Verfügbarkeitsprüfung). Asynchrone Verarbeitung läuft im Hintergrund – richtig für Massendaten, Imports, Berichte. Die meisten Plattformprobleme entstehen, wenn beide Muster verwechselt werden.

Datenformat: JSON ist Standard, XML lebt noch in Legacy-Welten

JSON (JavaScript Object Notation) ist das Standardformat moderner APIs – kompakt, gut lesbar, von jeder Programmiersprache verstanden. XML (eXtensible Markup Language) kommt noch in älteren Systemen vor, etwa bei Banken-Schnittstellen oder Behörden-APIs. Wer auf JSON setzt, baut auf einer Sprache, die das Web spricht.

Warum API-Strategie alle Entscheider gleichzeitig betrifft

API-Entscheidungen werden oft auf Entwickler-Ebene getroffen und betreffen am Ende das ganze Unternehmen. Wer IT, Marketing und Geschäftsführung früh einbindet, vermeidet teure Korrekturen nach dem Launch.

Architektur, Sicherheit, Wartbarkeit

APIs sind die Sollbruchstellen jeder Plattform. Bei „Kampmeyer“ entscheidet die onOffice-REST-API darüber, ob 100% redaktionelle Kontrolle möglich ist – kommt ein neues Objekt rein, ist es ohne manuelles Zutun auf der Website. Die IT-Leitung fragt: Welche Authentifizierung wird verwendet? Wer pflegt die Schnittstelle nach Go-Live? Was passiert bei API-Versionswechseln des Quellsystems? Wer hier keine Antworten hat, baut Wartungsaufwand auf, der später zur Kostenfalle wird.

Datenkonsistenz und Kampagnenfähigkeit

Wenn das CRM nicht mit dem CMS spricht, müssen Inhalte doppelt gepflegt werden – Objektdaten in onOffice und nochmal auf der Website, Standortdaten im internen System und nochmal in WordPress. APIs lösen genau dieses Problem: Daten werden einmal gepflegt und überall ausgespielt. Damit kann das Marketing-Team Kampagnen starten, ohne auf manuelle Synchronisation zu warten.

Souveränität, Wachstum, Investitionsschutz

Eine schlechte API-Architektur erzeugt Lock-In: Das Unternehmen kann den Dienstleister nicht wechseln, weil die Daten nicht mehr trennbar sind. Eine gute API-Architektur erzeugt das Gegenteil – digitale Souveränität. Die Geschäftsführung kann Systeme tauschen, Wachstum abbilden, neue Standorte anbinden, ohne die Plattform jedes Mal neu zu bauen.

Unsere Haltung zu API-Architektur

APIs sind die Sollbruchstelle jeder Plattform. Wer sie strategisch denkt, baut Souveränität. Wer sie technisch abhandelt, baut Abhängigkeit. Das klingt nach einer Selbstverständlichkeit – ist es in der Praxis aber selten.

In 500+ Projekten seit 2012 sehen wir immer wieder dasselbe Muster: Eine Agentur hat „eine API gebaut“, aber niemand weiß, welche Felder synchronisiert werden, wer die Authentifizierung verwaltet, was bei einem Versionswechsel passiert. Die API ist da – aber sie ist nicht dokumentiert, nicht modelliert, nicht steuerbar. Das ist keine API-Integration, das ist eine Datenleitung ohne Architektur-Konzept.

Wir behandeln APIs als Architekturentscheidung, nicht als Plugin-Frage. Konkret heißt das: Bevor wir eine Schnittstelle bauen, modellieren wir den Datenfluss – welche Felder, in welche Richtung, mit welcher Frequenz, mit welcher Fehlerlogik. Erst danach wird programmiert.

Das gemeinsame Muster:
Wir bauen APIs nicht für den Launch, sondern für die zehn Jahre danach.

Wo APIs in eurer Datenarchitektur greifen

API-Integrationen sind das verbindende Element in Data Enablement„. Sie machen die anderen Services erst möglich – ohne API keine Datenmodellierung, keine Dashboards, keine Auswertung.

Wenn ihr eure CRM-Architektur strukturieren wollt

Der Service „CRM Data Architecture“ modelliert Datenflüsse zwischen CRM, CMS und Fachsystemen. APIs sind dort die operative Umsetzung – die Frage „welche API“ beantworten wir, nachdem die Frage „welche Daten“ beantwortet ist.

Wenn ihr Daten zentral auswerten wollt

Der Service „BigQuery Setup“ bringt Daten aus verschiedenen Quellsystemen in ein zentrales Warehouse. Auch hier sind APIs die Voraussetzung – ohne sauber definierte Schnittstellen läuft das beste Warehouse leer.

Häufige Fragen zu API-Integrationen

Was ist der Unterschied zwischen REST und GraphQL?

REST ist das ältere, weiter verbreitete Architekturmuster: Das anfragende System ruft eine URL auf und bekommt einen festgelegten Datensatz zurück. GraphQL erlaubt dem anfragenden System, genau die Felder zu definieren, die es braucht – das reduziert Datenmenge und Komplexität bei großen Frontends. Für die meisten Business-Integrationen ist REST die richtige Wahl; GraphQL lohnt sich, wenn Datenmengen oder Frontend-Komplexität die REST-Grenzen sprengen.

Wie lange dauert eine typische API-Integration?

Das hängt von der Komplexität des Datenmodells ab, nicht von der Anzahl der Felder. Eine standardisierte REST-API mit klarer Dokumentation (onOffice, HubSpot, Salesforce) lässt sich in 2–4 Wochen produktiv anbinden, sobald die Datenmodellierung steht. Bei nicht-standardisierten Quellsystemen – etwa internen CRMs oder älteren ERPs – kann allein die Modellierung mehrere Wochen brauchen, weil erst geklärt werden muss, welche Felder überhaupt existieren und wie sie zusammenhängen.

Was passiert, wenn das angebundene System ausfällt?

Eine belastbare API-Integration plant den Ausfall mit ein. Cache-Schichten halten die letzten gültigen Daten vor, Fallback-Strategien zeigen statt Fehlermeldungen sinnvolle Inhalte, Monitoring meldet das Problem an die IT, bevor der Nutzer es merkt. Plattformen, die ohne diese Mechanismen gebaut sind, brechen beim ersten Ausfall des Quellsystems sichtbar zusammen – ein typisches Symptom für Integrationen, die ohne Architektur-Konzept gebaut wurden.

Wer ist nach Go-Live für die API verantwortlich?

Diese Frage gehört in den Vertrag, nicht in die letzte Sprint-Retro. Wir empfehlen eine geteilte Verantwortung: Das Quellsystem (CRM, ERP) verantwortet die API-Version und Datenqualität; die Plattform-Seite verantwortet Cache, Fallbacks und Monitoring. Beide Seiten dokumentieren ihre Vereinbarungen – Versionswechsel, Breaking Changes, Wartungsfenster. Klar geregelt entscheidet darüber, ob es später um Inhalt oder um Schuldfragen geht.

Wie ist die DSGVO bei API-Integrationen geregelt?

Personenbezogene Daten unterliegen auch innerhalb einer API-Integration der DSGVO. Konkret heißt das: dokumentierte Datenflüsse, klare Zweckbindung, technische und organisatorische Maßnahmen wie TLS-Verschlüsselung (Transport Layer Security), Zugriffsbeschränkung und Logging sowie Auftragsverarbeitungsverträge mit dem Quellsystem-Anbieter. Bei Cloud-APIs außerhalb der EU kommt die Standardvertragsklausel-Frage dazu. Wer hier sauber arbeitet, hat im DSGVO-Audit keine Überraschungen.

AI-Roadmap in 4–6 Wochen klären

Ihr plant eine Plattform-Architektur, in der mehrere Systeme zusammenarbeiten sollen, und wisst noch nicht, welche APIs in welcher Reihenfolge gebaut werden müssen? Wir klären in 4–6 Wochen Scope, Architektur und Datenflüsse – bevor eine Zeile Code geschrieben wird.

Hans Mengler

Bereit, Ihre Daten arbeiten zu lassen?