Wenn Applikationen und Websites miteinander sprechen

Im Berufsalltag passiert es täglich: Eine Formulareingabe auf der Website soll automatisch im CRM landen. Ein neuer Auftrag im Shop wird als Rechnung im Buchhaltungssystem verbucht. Ein Kalender auf der Vereinsseite zieht sich die aktuellen Spieldaten vom Verband. Ein Kundenstandort wird auf einer Karte angezeigt. In all diesen Fällen sprechen Applikationen miteinander – und das geschieht über APIs, zu Deutsch Schnittstellen.

APIs sind kein exklusives Entwickler-Thema. Sie entscheiden darüber, wie reibungslos dein Tagesgeschäft läuft, wie viel doppelte Datenerfassung dir erspart bleibt und wie gut deine Systeme zusammenspielen.

iBild wurde mit ChatGPT generiert

Was ist eine API eigentlich?

API steht für Application Programming Interface – eine klar definierte Schnittstelle, über die zwei Softwaresysteme miteinander kommunizieren können. Anschaulich gesprochen: eine API ist wie die Speisekarte in einem Restaurant. Sie listet auf, was bestellt werden kann, in welcher Form, und was man als Antwort zurückbekommt – ohne dass Gäste wissen müssen, wie die Küche im Hintergrund arbeitet.

Diese Entkopplung ist der eigentliche Clou: Dein CMS muss nicht wissen, wie Bexio intern Rechnungen berechnet, und Bexio muss nichts von deinem CMS verstehen. Beide sprechen das gemeinsame Protokoll der API und tauschen genau die Daten aus, die gebraucht werden.

Wo APIs deinen Alltag messbar einfacher machen

• Automatisierte Kundenkommunikation: Newsletter-Anmeldungen fliessen direkt in Mailchimp, ohne dass jemand Excel-Listen pflegt.
• Nahtlose Buchhaltung: Shop-Aufträge werden automatisch zu Rechnungen im ERP, Zahlungen aus Stripe oder TWINT verbucht und Kunden synchronisiert.
• Lebendige Inhalte: Sport-Websites zeigen Live-Tabellen, Buchungsseiten zeigen freie Termine, Standortseiten zeigen den nächsten offenen Standort – immer aktuell, ohne redaktionellen Aufwand.
• Effiziente Agentur- und Teamprozesse: Zeiterfassung, Projektplanung und Rechnungsstellung greifen ineinander, statt jeden Monat manuell kopiert zu werden.
• Besseres Marketing: Kampagnen, Newsletter und Website-Daten landen zusammengeführt im Analyse-Tool deiner Wahl.

Schnittstellen aus unserer Projektpraxis

Im Laufe der letzten Jahre haben wir in Kundenprojekten eine Vielzahl unterschiedlicher Systeme verbunden. Nicht jede Integration passt zu jedem Unternehmen – aber die Liste zeigt gut, wie breit das Spektrum ist:

OpenAPI: der gemeinsame Bauplan

Damit eine API nicht jedes Mal neu erklärt werden muss, hat sich ein Standard etabliert: OpenAPI (früher als Swagger bekannt). OpenAPI ist eine maschinenlesbare Beschreibung einer Schnittstelle – quasi die technische Speisekarte, als strukturiertes Dokument ausformuliert.

Warum das wichtig ist, auch wenn du selbst keine Zeile Code schreibst:

• Verlässliche Dokumentation: Was der Anbieter in der OpenAPI-Datei beschreibt, muss er auch liefern. Das reduziert Missverständnisse zwischen Dienstleister, Entwicklung und Fachbereich.
• Interaktive Tools: Aus einer OpenAPI-Datei entstehen automatisch durchklickbare Oberflächen (Swagger UI, Redoc, Stoplight), in denen du Endpunkte ausprobieren kannst – oft ohne eine Zeile zu programmieren.
• Automatisch generierter Code: Entwicklerinnen können aus einer OpenAPI-Spezifikation Client-Bibliotheken und Server-Grundgerüste generieren lassen. Das spart Zeit, reduziert Fehler und beschleunigt Prototypen erheblich.
• Einheitlicher Qualitätsanspruch: Schema-Validierung, Authentifizierung, Fehlercodes und Beispielwerte sind an einem Ort dokumentiert und lassen sich automatisch prüfen.

Bei bestehenden Produkten wie Stripe, Shopify oder Bexio bekommst du die OpenAPI-Dokumentation gleich mitgeliefert – in der Regel unter einer URL wie /api/docs oder /openapi.json. Bei eigenen Schnittstellen empfehlen wir, die OpenAPI-Spezifikation von Beginn an mitzudenken: Sie ist die Verständigungsgrundlage zwischen Fachseite und Technik – und sie bleibt lange nach Projektende ein wertvolles Dokument.

OpenAPI und KI-Agenten (ChatGPT, Claude & Co.)

Ein Aspekt, der bis vor kurzem akademisch gewirkt hätte, wird aktuell richtig spannend: KI-Systeme wie ChatGPT Custom GPTs, ChatGPT Actions oder Claude Tool Use können anhand einer OpenAPI-Spezifikation selbständig mit deiner Schnittstelle sprechen. Du lädst eine OpenAPI-Datei hoch – der Assistent versteht daraufhin, welche Endpunkte verfügbar sind, welche Parameter sie erwarten und welche Antwort zurückkommt. Er kann daraus autonom Aufrufe generieren und deren Ergebnisse in die laufende Konversation einbinden.

In der Praxis bedeutet das: Mit einer gepflegten OpenAPI-Datei machst du deine Systeme nicht nur für klassische Software ansprechbar, sondern auch für KI-Assistenten – zum Beispiel für eigene interne Helferlein («Zeige mir alle offenen Rechnungen ab 1'000 CHF»), für kundenseitige GPTs oder für agenteure Automatisierungen, die über mehrere Systeme hinweg arbeiten. Was gestern noch ein Entwicklerprojekt war, lässt sich heute in Stunden an KI-Oberflächen anbinden – sofern deine Schnittstelle sauber dokumentiert ist.

Gleichzeitig gilt: Gerade wenn KI-Agenten Zugriff auf produktive Daten bekommen, werden saubere Authentifizierung, differenzierte Berechtigungen, Ratenbegrenzungen und Logging noch wichtiger. Eine OpenAPI-Datei beschreibt auch diese Schutzmechanismen – sie sind kein «nice to have», sondern Teil der Spezifikation.

Was du vor einer Integration klären solltest

Technisch ist heute fast alles möglich. Ob eine Integration aber wirklich Sinn ergibt, hängt von weichen Faktoren ab, die im ersten Gespräch oft untergehen:

• Datenhoheit: Wer ist das führende System? Wer darf Daten ändern, wer darf nur lesen?
• Richtung: Einweg-Import, regelmässiger Abgleich oder bidirektionale Synchronisation?
• Frequenz: Echtzeit-Webhook, stündlich, täglich? Rate Limits und Kosten variieren deutlich.
• Fehlerbehandlung: Was passiert, wenn die API einmal nicht antwortet – soll der Prozess warten, zurückstellen oder jemanden informieren?
• Authentifizierung: API-Key, OAuth, Zertifikat – mit welchen Zugängen arbeitest du, und wer darf sie sehen?
• Datenschutz: Welche Personendaten fliessen wohin? Ist das mit der eigenen Datenschutzerklärung und der DSG-/DSGVO-Lage vereinbar?
• Betrieb & Wartung: APIs ändern sich. Wer bemerkt das, wer reagiert, wer bezahlt Folgeanpassungen?

Wie ein API-Projekt typischerweise abläuft

• Analyse: Zieldefinition, beteiligte Systeme, Datenmodelle und Anwendungsfälle beschreiben.
• Konzept: Datenflüsse zeichnen, führendes System definieren, Grenzfälle durchdenken.
• Prototyp: Kleine, isolierte Schnittstelle mit echten Daten testen – Tempo, Stabilität und Edge-Cases prüfen.
• Umsetzung: Saubere Integration mit Logging, Monitoring und klaren Fehlermeldungen.
• Betrieb: Laufende Beobachtung, Versionsupdates und Anpassung an veränderte Geschäftsprozesse.

Zwei Systeme, die nicht miteinander sprechen?

Wenn du den Eindruck hast, dass in deinem Alltag zu oft von Hand kopiert, exportiert oder eingetippt wird, lohnt sich ein Blick auf die vorhandenen APIs. Wir analysieren, was möglich ist, schlagen pragmatische Lösungen vor und setzen sie sauber, wartbar und datenschutzkonform um.

ahoi@pixelwerft.ch

← Zurück zur Übersicht aller Fragen & Antworten