Schnittstellen einfach erklärt: Was eine API ist und wann du eine brauchst

01Der Kellner zwischen Tisch und Küche

Stell dir ein Restaurant vor. Du gehst nicht selbst in die Küche und rührst in den Töpfen. Du sagst dem Kellner, was du möchtest, er gibt die Bestellung in einer Form weiter, mit der die Küche arbeiten kann, und bringt dir später das Essen. Genau das ist eine API zwischen zwei Programmen: eine vereinbarte Übergabestelle, an der Anfragen ankommen und Antworten zurückgehen, ohne dass ein Programm im Inneren des anderen herumhantiert.

API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Das Wort klingt größer als die Sache. Im Kern ist es eine Absprache darüber, welche Fragen ein System beantwortet, in welcher Form die Antwort kommt und was bei Fehlern passiert.

02Ein Beispiel aus dem Handel, einmal durchgespielt

Angenommen, dein Shop und deine Warenwirtschaft sind über eine Schnittstelle verbunden. Dann läuft eine Bestellung so durch:

• Ein Kunde bestellt im Shop. Der Shop meldet die Bestellung sofort an die Warenwirtschaft.
• Die Warenwirtschaft bucht den Artikel vom Lagerbestand ab. Wird der Bestand knapp, geht eine Meldung an den Einkauf.
• Aus den Bestelldaten entsteht die Rechnung und landet in der Buchhaltung.
• Der Kunde bekommt die Versandbestätigung mit Sendungsnummer, ohne dass irgendwer etwas abtippt.

Kein einzelner Schritt davon ist spektakulär. Der Wert liegt darin, dass die Kette von allein läuft, auch nachts, auch am Wochenende, auch wenn gerade niemand Zeit hat.

03Woran du merkst, dass eine Schnittstelle fehlt

• Jemand kopiert Daten per Copy-Paste von einem Fenster ins andere.
• Excel-Exporte wandern per Mail von einem Programm ins nächste.
• Dieselben Adressen oder Artikel werden in zwei Systemen gepflegt und laufen langsam auseinander.
• Am Monatsende sucht jemand stundenlang, warum zwei Listen nicht übereinstimmen.

Einzeln fällt keiner dieser Handgriffe auf. In Summe sind sie teuer, und jeder einzelne ist eine Gelegenheit für Tippfehler, die später viel Zeit kosten.

04Was eine Anbindung realistisch braucht

• Beide Systeme brauchen eine API. Bei moderner Software ist das der Normalfall, bei älteren Programmen lohnt die Nachfrage beim Hersteller.
• Ein Mapping: die Festlegung, welches Feld im einen System zu welchem Feld im anderen gehört. Das ist mehr Denkarbeit als Programmierarbeit.
• Fehlerbehandlung: Ist ein System kurz nicht erreichbar, versucht eine gute Anbindung es später erneut und meldet sich, statt still Daten zu verlieren.
• Monitoring: Eine Anbindung, die niemand überwacht, fällt erst auf, wenn Bestellungen fehlen. Ein einfacher täglicher Statusbericht reicht oft schon.

Eine Schnittstelle ist kein Konzernprojekt. Viele Anbindungen zwischen zwei Systemen sind in Tagen gebaut, nicht in Monaten. Entscheidend ist die Vorarbeit: genau klären, welche Daten in welche Richtung fließen sollen.

05Fertige Integration oder eigene Anbindung?

Viele Tools bringen fertige Integrationen zu gängiger Software mit, und wenn es eine gibt, probiere sie zuerst. Eine eigene Anbindung lohnt sich, wenn die fertige ein wichtiges Feld nicht überträgt, wenn dein Ablauf vom Standard abweicht oder wenn eines der Systeme älter ist. Der Vorteil der eigenen Lösung: Sie passt sich deinem Prozess an, nicht umgekehrt.