API
Eine API (Application Programming Interface) ist eine festgelegte Programmierschnittstelle, über die eine Software Daten und Funktionen eines anderen Systems nutzen kann. Sie beschreibt, welche Anfragen erlaubt sind, welche Daten zurückkommen und wie sich ein Programm anmeldet.
Erklärung
Eine API ist so etwas wie ein Bestellschalter. Ein Programm stellt eine Anfrage in einem vereinbarten Format, etwa „gib mir alle Bestellungen seit gestern“, und erhält eine Antwort in einem ebenso vereinbarten Format. Was hinter dem Schalter passiert, bleibt verborgen. Das ist gewollt: Der Hersteller kann sein System intern ändern, solange die API gleich bleibt.
Heute arbeiten die meisten Web-APIs nach dem REST-Prinzip und tauschen Daten im Format JSON aus. Für die Anmeldung verwenden sie API-Schlüssel oder Verfahren wie OAuth 2.0. Viele APIs begrenzen außerdem, wie viele Anfragen pro Minute erlaubt sind. Eine gute API hat eine vollständige Dokumentation und eine Testumgebung.
Beispiel aus dem Schnittstellen-Alltag
Ein Onlineshop soll jede Nacht die Bestellungen des Vortags an die Buchhaltung übergeben. Die Schnittstelle fragt dazu über die API des Shops die neuen Bestellungen ab, liest Beträge, Steuersätze und Zahlungsart und legt über die API der Buchhaltungssoftware passende Belege an. Meldet eine API einen Fehler, etwa weil ein Pflichtfeld fehlt, wird der Datensatz protokolliert und erneut versucht.
Abgrenzung zu verwandten Begriffen
- Schnittstelle ist der Oberbegriff. Eine API ist eine Form davon. Schnittstellen können auch über Dateien oder Datenbanken laufen.
- Ein Webhook ist die Gegenrichtung: Nicht Sie fragen an, sondern das System meldet sich bei einem Ereignis von selbst.
- Middleware nutzt die APIs mehrerer Systeme und vermittelt zwischen ihnen.
Bezug zu unseren Leistungen
Wir verbinden Systeme über ihre APIs direkt von A nach B. Wie gut die API eines Systems ist, beeinflusst den Aufwand und damit den Festpreis, siehe Was kostet eine Schnittstelle? Hat ein System keine API, binden wir es über Datei, Datenbank oder Export an: Anbindung ohne API.
Häufige Fragen
Ist API dasselbe wie Schnittstelle?
Nicht ganz. Jede API ist eine Schnittstelle, aber nicht jede Schnittstelle ist eine API. Ein regelmäßiger CSV-Export ist auch eine Schnittstelle.
Kostet die Nutzung einer API Geld?
Das hängt vom Hersteller ab. Manche Systeme stellen die API nur in bestimmten Tarifen bereit. Das sollte vor dem Projekt geprüft werden.
Passend dazu
Schnittstelle
Eine Schnittstelle verbindet zwei Systeme, damit sie Daten automatisch austauschen. Definition, Beispiel aus dem Alltag und Abgrenzung zu API und Middleware.
Webhook
Ein Webhook ist eine automatische Nachricht, die ein System bei einem Ereignis an eine Adresse sendet. Erklärung, Beispiel und Unterschied zu API und Polling.
Schnittstelle programmieren lassen
Direkte Verbindung zwischen zwei Systemen, Festpreis nach kostenlosem Check, Code gehört Ihnen.
