API-Schnittstelle erklärt: wie Software im KMU miteinander spricht

Eine API-Schnittstelle ist die festgelegte Verbindungsstelle, über die zwei Programme miteinander sprechen. API steht für Application Programming Interface, auf Deutsch etwa «Programmierschnittstelle». Eine Software stellt über die API eine Anfrage, zum Beispiel «lege diesen neuen Kontakt an» oder «gib mir alle offenen Rechnungen», und die andere Software antwortet in einem vereinbarten Format. Kein Mensch muss Daten kopieren, und keine Seite muss wissen, wie die andere intern aufgebaut ist.

Ein gutes Bild ist der Schalter eines Amtes. Man muss nicht wissen, wie es hinter dem Schalter organisiert ist. Man muss nur wissen, welches Formular man abgibt und was man zurückbekommt. Die API ist dieser Schalter, und ihre Dokumentation beschreibt die Formulare.

Für ein KMU ist das kein Technikdetail. Ob die eigenen Programme über APIs verbunden sind oder nicht, entscheidet darüber, ob Daten einmal erfasst und dann automatisch weitergereicht werden oder ob jemand im Büro sie zwei-, drei- oder viermal von Hand überträgt.

Wo APIs im KMU-Alltag stecken

Viele KMU nutzen APIs täglich, ohne es zu merken. Einige typische Beispiele:

Das letzte Beispiel wird gerade wichtiger. Sprachmodelle können über sogenanntes Tool Calling eigene Werkzeuge aufrufen, und diese Werkzeuge sind in aller Regel APIs. Wer KI im Betrieb produktiv einsetzen will, braucht deshalb Systeme, die sich ansprechen lassen. Mehr dazu auf unserer Seite zu KI-Automatisierung für KMU.

Die wichtigsten Begriffe, kurz erklärt

REST-API. Die heute verbreitetste Form. Daten werden über normale Web-Adressen abgefragt und meist im Format JSON zurückgegeben. Wenn ein Anbieter «wir haben eine API» sagt, meint er fast immer eine REST-API.

Webhook. Die umgekehrte Richtung. Statt dass die eigene Software regelmässig nachfragt, ob es Neues gibt, meldet sich die andere Seite von selbst, sobald etwas passiert, etwa wenn eine Zahlung eingeht. Webhooks sparen Abfragen und machen Abläufe schneller.

Authentifizierung. Jede seriöse API verlangt einen Schlüssel oder ein Anmeldeverfahren, damit nur Berechtigte zugreifen. Diese Schlüssel sind so sensibel wie Passwörter und gehören nicht in E-Mails oder Tabellen.

Rate Limit. Die meisten APIs begrenzen, wie viele Anfragen pro Minute oder Stunde erlaubt sind. Für kleine Datenmengen ist das selten ein Problem, bei grossen Importen schon.

Dokumentation. Die Beschreibung, welche Anfragen möglich sind und welche Daten zurückkommen. Eine API ohne brauchbare Dokumentation ist in der Praxis kaum besser als keine.

Headless. Systeme, die ihre Inhalte nur über eine API ausliefern und keine eigene Oberfläche vorschreiben. Das erlaubt, dieselben Daten auf Website, App und anderen Kanälen zu nutzen. Der Glossarbegriff Headless Architecture erklärt das Prinzip.

Ein Beispiel: Reservation, Push und WhatsApp

Wie das im Alltag aussieht, zeigt die Website, die wir für das Restaurant Han Kitchen in Zürich-Oerlikon gebaut haben. Ein Gast reserviert auf der Website in drei Schritten. Die Reservation wird gespeichert, und im selben Moment löst sie eine Push-Benachrichtigung auf dem Handy des Restaurants aus, mit Name, Datum, Uhrzeit und Personenzahl. Parallel geht zur Sicherheit eine E-Mail ans Restaurant. Die Push-Nachricht nutzt dabei eine Schnittstelle, die moderne Browser für Web-Apps bereitstellen.

Interessant ist der letzte Schritt. Zum Bestätigen erscheint in der Admin-App ein vorformulierter, anpassbarer Text. Ein Tipp auf «Per WhatsApp» öffnet ihn direkt im WhatsApp des Restaurants, und die Nachricht geht vom eigenen Konto an den Gast, ohne Kosten pro Nachricht. Für diesen Schritt braucht es keine kostenpflichtige Anbindung an eine Messaging-Plattform. Wann sich die WhatsApp-Business-API dagegen lohnt, vergleicht WhatsApp Business für KMU; wie Web-Push technisch funktioniert, erklärt Push-Nachrichten für Unternehmen. Das Beispiel zeigt etwas Grundsätzliches: Die beste Integration ist nicht immer die technisch aufwendigste, sondern die, die den Ablauf mit den wenigsten beweglichen Teilen löst.

Ein zweites Beispiel ist die Betriebssoftware von Karo Kanaltechnik. Dort greifen Website und Software auf dieselben Daten zurück, und Offerte, Einsatzplanung, Rapport, Rechnung mit Schweizer QR-Zahlteil und Kundenportal hängen direkt zusammen. Weil alles in einem System liegt, entfällt ein grosser Teil der Schnittstellen, die man bei mehreren eingekauften Einzellösungen bräuchte.

Wovon der Aufwand einer Anbindung abhängt

Ob eine Integration in einem Nachmittag oder in mehreren Wochen erledigt ist, hängt selten an der Programmiersprache. Entscheidend sind diese Fragen:

1. Haben beide Systeme eine offene, dokumentierte API? Wenn ja, ist das die halbe Miete. Wenn nicht, beginnt die Suche nach Umwegen.
2. Fliessen die Daten in eine oder in beide Richtungen? Eine Einbahnstrasse, etwa Formular zu CRM, ist einfach. Eine zweiseitige Synchronisation, bei der Änderungen auf beiden Seiten abgeglichen werden müssen, ist ein eigenes Projekt.
3. Wie viele Felder müssen zugeordnet werden? «Name» und «E-Mail» sind schnell verbunden. Unterschiedliche Kundennummern, Adressformate oder Mehrwertsteuersätze brauchen Regeln.
4. Was passiert bei Fehlern? Eine Anbindung, die bei einem Ausfall der Gegenseite stillschweigend Daten verliert, ist gefährlicher als gar keine. Wiederholungsversuche, Fehlerprotokoll und eine Benachrichtigung gehören dazu.
5. Wer wartet die Anbindung? Anbieter ändern ihre APIs und stellen alte Versionen ab. Jede Integration braucht jemanden, der das im Blick behält.

Für einfache Einbahnstrassen reichen oft Automatisierungswerkzeuge wie Zapier, Make oder n8n, die zahlreiche fertige Verbindungen zu gängiger Software mitbringen. Einen Vergleich bietet n8n, Make oder Zapier. Wo Abläufe zum Kern des Geschäfts gehören, viele Systeme beteiligt sind oder Daten sensibel sind, lohnt sich eine eigene, saubere Integration. Wie wir solche Vorhaben angehen, steht unter Individualsoftware Schweiz; einen Überblick über die Kostenfaktoren gibt Software-Kosten Schweiz.

Was passiert, wenn eine Software keine API hat

Viele ältere Branchenlösungen und manche günstige Software bieten keine oder nur eine sehr eingeschränkte Schnittstelle. Dann bleiben Umwege:

• Export und Import. Regelmässig eine CSV-Datei exportieren und im anderen System einlesen. Funktioniert, ist aber verzögert und anfällig für Formatfehler.
• E-Mail-Auswertung. Systeme verschicken Benachrichtigungen, die automatisch gelesen und weiterverarbeitet werden. Bricht, sobald der Anbieter den Text ändert.
• Automatisierte Bedienung der Oberfläche. Ein Programm klickt sich durch die Software wie ein Mensch. Das ist die letzte Möglichkeit und wartungsintensiv.

Alle drei Wege haben dasselbe Problem: Sie hängen an Dingen, die der Anbieter jederzeit ändern darf, ohne Rücksicht zu nehmen. Eine dokumentierte API ist dagegen ein Versprechen, das Anbieter in der Regel mit Versionierung und Vorlaufzeiten absichern. Wer heute eine Software ohne Schnittstelle kauft, schafft sich deshalb eine Form von Vendor-Lock-in: Die Daten sind drin, kommen aber schwer wieder heraus.

Fragen an jeden Softwareanbieter

Bevor ein KMU eine neue Software kauft, insbesondere CRM, Buchhaltung, Shop oder Branchenlösung, lohnen sich diese Fragen:

• Gibt es eine öffentlich dokumentierte API, und ist sie im gewählten Abo enthalten oder kostet sie extra?
• Welche Daten lassen sich lesen, welche schreiben? Manche APIs erlauben nur das Auslesen.
• Gibt es Webhooks für die wichtigsten Ereignisse?
• Gibt es fertige Verbindungen zu den Werkzeugen, die wir schon nutzen?
• Wie werden API-Änderungen angekündigt, und wie lange bleiben alte Versionen verfügbar?
• Wo werden die Daten gespeichert, und was gilt beim Export, wenn wir den Anbieter wechseln?

Wer diese Fragen beim Kauf stellt, spart sich später teure Bastellösungen. Wenn das CRM das Herz der Abläufe ist, vertieft unsere Seite CRM entwickeln lassen die Frage, wann ein eigenes System mit sauberen Schnittstellen sinnvoller ist als ein gekauftes.

Fazit

Eine API-Schnittstelle ist die Verbindung, über die Programme Daten austauschen, ohne dass Menschen sie abtippen. Im KMU entscheidet sie darüber, ob ein Kontakt, eine Bestellung oder eine Zahlung einmal erfasst und dann automatisch weitergereicht wird oder ob jemand im Büro dieselben Daten mehrmals eingibt. Wer bei jeder Softwareanschaffung nach einer offenen, dokumentierten API fragt und Anbindungen mit Blick auf Fehlerbehandlung und Wartung plant, legt die Grundlage für Automatisierung, für KI-Anwendungen und für einen späteren Anbieterwechsel ohne Datenverlust.