API

Was eine API ist

Eine API ist eine definierte Schnittstelle, über die zwei Systeme miteinander sprechen. Sie beschreibt, welche Anfragen möglich sind und welche Antwort darauf kommt, ohne dass das anfragende System die Innenseite des anderen kennen muss. Im Bild: Die API ist die Speisekarte, nicht die Küche. Wer bestellt, muss nicht wissen, wie gekocht wird.

Im Online-Handel ist die API-Frage fast immer eine Projektfrage. Ob Warenwirtschaft, Marktplatz, Newsletter, Versand oder ein KI-Werkzeug angebunden werden soll, ob hängt davon ab, ob der Anbieter eine API hat und ob sie die benötigten Felder liefert.

Welche Arten es gibt

Am verbreitetsten ist die REST-Schnittstelle. Sie arbeitet mit einzelnen Adressen, die je eine Sache bezeichnen, und nutzt die Standardmethoden des Webs zum Lesen, Anlegen, Ändern und Löschen. Sie ist einfach zu verstehen und gut zu testen, was sie zur üblichen Wahl macht.

Daneben gibt es GraphQL, wo ein Aufruf mehrere zusammenhängende Dinge in einer Anfrage liefert, was bei verschachtelten Daten wie Produktvarianten Vorteile bringt. Älter sind SOAP-Schnittstellen, die noch in manchen Warenwirtschaftssystemen stecken. Und mit Webhooks beginnt die Umkehr: Statt beim Partner nachzufragen, meldet sich der Partner bei einem Ereignis von selbst. Für Änderungen, die sofort ankommen sollen, ist das der richtige Weg.

Worauf es bei der Auswahl ankommt

• Vollständigkeit: Deckt die Schnittstelle die Felder ab, die gebraucht werden. Eine API für Stammdaten ohne Bilder hilft nur halb.
• Menge der Aufrufe: Viele Anbieter begrenzen, wie oft in einem Zeitraum angefragt werden darf. Ein Abgleich über hunderttausend Artikel kann daran scheitern.
• Zugangsverfahren: Wie meldet sich das System an, und wie werden Schlüssel erneuert. Ohne saubere Schlüsselverwaltung entstehen Sicherheitslücken.
• Verhalten bei Fehlern: Kommt eine verständliche Meldung, und darf ein Aufruf wiederholt werden. Beides entscheidet über die Stabilität.
• Änderungsmitteilungen: Ein Anbieter, der seine Schnittstelle ohne Vorlauf ändert, bricht jede Anbindung.

Was beim Betrieb schiefgeht

Der erste Fehler ist der fehlende Abgleich nach dem ersten Import. Eine Anbindung, die einmal Daten übernimmt und danach nur noch in eine Richtung schreibt, führt zu zwei Beständen der Wahrheit. Nach kurzer Zeit unterscheiden sich Preise und Bestände, und niemand weiß, welcher Wert gilt.

Der zweite Fehler ist die fehlende Protokollierung. Ohne Protokoll der Aufrufe lässt sich bei einem Fehler nicht sagen, ob die Daten falsch geliefert, falsch verarbeitet oder gar nicht angekommen sind. Der dritte Fehler ist die fehlende Warteraum-Regel: Bricht der Partner für Stunden weg, muss der eigene Prozess die Anfragen sammeln und später senden, statt sie zu verlieren.

Häufige Fragen

• Brauche ich eine API für kleine Anbindungen? Nicht immer. Ein regelmäßiger Dateiaustausch reicht, wenn Verzögerungen von Stunden unproblematisch sind.
• Was ist ein API-Schlüssel? Ein Ausweis für das System. Er gehört behandelt wie ein Passwort und nie in den Quelltext einer Seite.
• Wie teste ich eine Schnittstelle? Mit einzelnen Aufrufen von Hand, bevor die Automatik gebaut wird. Das spart die meisten Fehlersuchen.