Ein Mensch bedient ein Programm über die Oberfläche: Er klickt auf Masken, füllt Felder aus, drückt auf Speichern. Ein anderes Programm braucht dafür einen eigenen Zugang, und das ist die API. Sie legt fest, welche Anfragen ein System von außen annimmt, in welcher Form die Daten ankommen müssen und was es zurückgibt. Das CRM etwa bietet an: „Gib mir den Kunden mit dieser Nummer“, „Lege einen neuen Kontakt an“, „Ändere die Telefonnummer“. Wie das CRM die Daten intern speichert, bleibt verborgen, und genau das ist der Zweck. Solange die Schnittstelle gleich bleibt, kann der Hersteller dahinter umbauen, ohne dass angeschlossene Systeme brechen.
Im Alltag der Automatisierung ist mit API fast immer eine Web-API gemeint: Ein Programm schickt über das Netz eine Anfrage nach den Regeln von HTTP und bekommt eine Antwort, meist im Datenformat JSON. Das ist dieselbe Technik, mit der ein Browser Webseiten lädt, nur dass am anderen Ende kein Mensch eine Seite liest, sondern ein Programm einen Datensatz verarbeitet.
Wie eine Anfrage aufgebaut ist
Eine Web-API-Anfrage besteht im Kern aus vier Teilen. Die Adresse (der Endpunkt) sagt, worum es geht, etwa die Rechnungen eines bestimmten Kunden. Die Methode sagt, was geschehen soll: GET liest, POST legt etwas an, PUT oder PATCH ändert, DELETE löscht. Die Kopfzeilen tragen Angaben wie den Zugangsschlüssel und das Datenformat. Der Inhalt enthält bei schreibenden Anfragen die eigentlichen Daten.
Die Antwort beginnt mit einem Statuscode. Codes ab 200 bedeuten Erfolg, ab 400 hat der Aufrufer etwas falsch gemacht (fehlende Berechtigung, unbekannter Datensatz, ungültige Daten), ab 500 liegt der Fehler beim angefragten System. Diese Bedeutungen sind in der IETF-Norm RFC 9110 festgelegt, die die Semantik von HTTP beschreibt. Für eine Automatisierung ist die Unterscheidung wichtig: Viele Fehler der 500er-Gruppe sind vorübergehend, ein erneuter Versuch nach einer Pause kann gelingen. Bei den meisten Fehlern der 400er-Gruppe ist das zwecklos, denn derselbe falsche Aufruf scheitert beim zweiten Mal genauso. Eine wichtige Ausnahme ist der Code 429 („zu viele Anfragen“, festgelegt in RFC 6585): Hier lohnt es, kurz zu warten und es dann erneut zu versuchen.
RFC 9110 definiert außerdem, welche Methoden idempotent sind, also bei mehrfacher Ausführung dieselbe Wirkung haben wie bei einmaliger: GET, PUT und DELETE gehören dazu, POST nicht. Das klingt akademisch, entscheidet aber im Betrieb, ob ein automatischer Wiederholungsversuch harmlos ist oder eine Rechnung doppelt anlegt.
Woran man eine brauchbare API erkennt
Dass ein System „eine API hat“, sagt noch wenig. Für die Frage, ob sich ein Ablauf darüber automatisieren lässt, zählen andere Punkte.
Abdeckung. Kann die API alles, was der Ablauf braucht? Häufig lassen sich Stammdaten lesen, aber keine Belege anlegen, oder Aufträge anlegen, aber keine Anhänge hochladen. Eine Lücke an einer einzigen Stelle reicht, damit ein Mensch wieder von Hand nachtragen muss.
Dokumentation. Gute Anbieter beschreiben ihre Schnittstelle maschinenlesbar, meist im Format der OpenAPI Specification. Die Spezifikation der OpenAPI Initiative legt fest, wie Endpunkte, Parameter, Datenstrukturen und Anmeldeverfahren beschrieben werden, sodass Menschen und Werkzeuge die Fähigkeiten eines Dienstes verstehen, ohne den Quellcode zu kennen. Eine solche Beschreibung erspart viel Probieren.
Anmeldung und Rechte. Verbreitet sind einfache API-Schlüssel und das Verfahren OAuth 2.0 (RFC 6749), bei dem ein Programm ein zeitlich begrenztes Zugriffstoken für genau festgelegte Rechte erhält. Entscheidend ist, ob sich die Rechte fein zuschneiden lassen. Eine Automatisierung, die nur Rechnungen lesen soll, sollte keinen Schlüssel bekommen, der auch Stammdaten löschen darf. Das ist das Prinzip der minimalen Rechte, angewendet auf Maschinen.
Fehlermeldungen. Eine gute API sagt, was schiefging. RFC 9457 beschreibt dafür ein einheitliches Format („Problem Details“) mit Typ, Titel und Beschreibung des Fehlers. Wer nur „Error 400“ zurückbekommt, sucht lange.
Grenzen. Fast jede API begrenzt, wie viele Anfragen pro Zeiteinheit erlaubt sind. Für eine nächtliche Synchronisation von zehntausenden Artikeln ist das eine harte Planungsgröße, für ein einzelnes Kundenticket meist nicht.
Versionierung. Anbieter ändern Schnittstellen. Seriöse kündigen das an, führen neue Versionen parallel und schalten alte erst nach einer Frist ab. Fehlt diese Zusage, kann ein Update beim Anbieter eine laufende Automatisierung über Nacht stilllegen.
Abfragen oder benachrichtigt werden
Eine API funktioniert nach dem Prinzip Frage und Antwort: Das aufrufende Programm muss selbst nachsehen. Will man wissen, ob im Ticketsystem ein neues Ticket eingegangen ist, fragt man in festen Abständen nach. Das nennt man Polling. Es ist einfach, aber entweder träge (bei langen Abständen) oder verschwenderisch (bei kurzen).
Die Umkehrung ist der Webhook: Das Ticketsystem meldet sich von selbst, sobald etwas passiert. In der Praxis arbeiten beide zusammen. Der Webhook meldet „Ticket 4711 ist neu“, die API holt danach die vollständigen Daten und schreibt das Ergebnis zurück.
Was tun, wenn ein System keine API hat
Ältere Branchensoftware, manche Warenwirtschaft im Mittelstand und viele selbst entwickelte Anwendungen bieten keine oder nur eine sehr eingeschränkte Schnittstelle. Dann gibt es drei Auswege, jeder mit Preis.
Manchmal lässt sich direkt auf die Datenbank zugreifen. Das ist schnell, umgeht aber alle Prüfungen der Anwendung und kann bei einem Update brechen, weil der Hersteller die interne Struktur nie zugesagt hat. Manche Systeme können Dateien in festen Formaten austauschen, etwa CSV-Exporte in einem Verzeichnis. Das ist robust, aber nicht in Echtzeit. Bleibt nur die Oberfläche, kann eine Software sie wie ein Mensch bedienen; das ist Robotic Process Automation, die bei jeder Änderung an der Maske nachgezogen werden muss.
Wer neue Software für CRM, ERP, DMS oder Ticketsystem auswählt, sollte die API deshalb als Auswahlkriterium behandeln und nicht als Fußnote. Sinnvolle Fragen an den Anbieter: Ist die Schnittstelle öffentlich dokumentiert? Kostet sie extra? Welche Objekte lassen sich lesen und schreiben? Gibt es Webhooks? Wie lange werden alte Versionen unterstützt?
APIs und KI
Sprachmodelle werden selbst über APIs angesprochen, und sie können ihrerseits APIs nutzen. Beim Function Calling beschreibt man dem Modell verfügbare Funktionen, und das Modell entscheidet, wann es welche mit welchen Werten aufrufen möchte. Ausgeführt wird der Aufruf von der umgebenden Software, nicht vom Modell. Das ist der Punkt, an dem man kontrolliert, was erlaubt ist. Eine API, die für menschliche Nutzer mit Bestätigungsdialogen gedacht war, kennt diese Sicherung nicht; sie führt aus, was ankommt. Für KI-gesteuerte Abläufe gelten Rechtevergabe und Protokollierung deshalb eher strenger als für klassische Systemintegration.
Quellen
- RFC 9110: HTTP Semantics, Internet Engineering Task Force (IETF), 2022
- OpenAPI Specification v3.2.1, OpenAPI Initiative
- RFC 6749: The OAuth 2.0 Authorization Framework, Internet Engineering Task Force (IETF), 2012
- RFC 9457: Problem Details for HTTP APIs, Internet Engineering Task Force (IETF), 2023
- RFC 6585: Additional HTTP Status Codes, Internet Engineering Task Force (IETF), 2012
Inhaltlich geprüft im Oktober 2026. Der Eintrag erklärt einen Begriff und ersetzt keine Rechts- oder Steuerberatung.

