API / Schnittstelle

Denken Sie an die Durchreiche zwischen Küche und Gastraum. Der Kellner geht nicht selbst an den Herd, und der Koch trägt nicht auf. Es gibt eine Stelle, an der ein Zettel hineingeht und ein Teller herauskommt. Beide Seiten wissen genau, was sie voneinander erwarten dürfen — und keine Seite muss die Arbeit der anderen verstehen.

Genau so arbeitet eine API (kurz für „Schnittstelle zur Programmierung“): ein festgelegter Satz von Fragen, die ein Programm an ein anderes stellen darf, samt der Form der Antwort. Ihre Website fragt Ihre Warenwirtschaft: „Wie viele Stück von Artikel 4711 sind auf Lager?“ und bekommt eine Zahl zurück. Wie die Warenwirtschaft intern zählt, bleibt ihre Sache.

Der häufigste Irrtum: Eine Schnittstelle sei ein Produkt, das man kauft und einschaltet. Sie ist eher ein Vertrag. Dass ein Anbieter „eine API hat“, heißt nur, dass Fragen erlaubt sind — nicht, dass Ihre Felder zu seinen passen. Ob Ihr „Kundennummer“ dort „customer_id“ heißt und ob Preise mit oder ohne Steuer geliefert werden, ist Übersetzungsarbeit, und die ist der eigentliche Aufwand einer Anbindung.

Zwei Dinge gehören immer dazu: ein Zugangsschlüssel, der wie ein Passwort behandelt werden muss, und eine Obergrenze für Anfragen. Wer nicht ständig nachfragen will, dreht die Richtung um und lässt sich Bescheid geben — dafür gibt es Webhooks.

Jede Zahl, die Sie an zwei Stellen von Hand pflegen, ist irgendwann an einer der beiden falsch. Eine Schnittstelle beendet das: Preise, Lagerstände, freie Termine oder Fahrzeugdaten stehen genau einmal in Ihrem System und erscheinen automatisch auf der Website.

Fragen Sie vor einem Projekt, ob Ihr vorhandenes System eine dokumentierte Schnittstelle mitbringt. Wenn ja, sinkt der Aufwand erheblich. Wenn nein, ist das kein Ausschlusskriterium, aber ein Posten im Angebot — dann bauen wir die Brücke selbst, notfalls über eine eigene kleine Anwendung.