Was ist eine API-Anbindung und was bringt sie Ihrem Webshop?

Was ist eine API und was macht eine API-Anbindung?

Eine API ist ein Satz von Vereinbarungen, mit dem Software mit anderer Software sprechen kann, statt dass ein Mensch auf einem Bildschirm klickt. Stellen Sie sich den Schalter eines Systems vor: Sie fragen in fester Form etwas an und bekommen in fester Form eine Antwort ¹. Eine API-Anbindung nutzt diesen Schalter, damit zwei Systeme zusammenarbeiten.

Bei einem Webshop geht es meist um vier Arten von Daten:

• Bestand. Ein Verkauf im einen System senkt die Menge im anderen. Lesen Sie auch, wie Sie Bestand über Kanäle synchronisieren.
• Preise. Eine Preisänderung an einer Stelle kommt überall an.
• Produktdaten. Titel, Beschreibungen, Fotos und Attribute gehen von der Quelle zu den Kanälen.
• Bestellungen. Eine Bestellung erreicht die Stelle, die sie bearbeitet, und Status oder Sendungsnummer gehen zurück.

Das ist dasselbe Ziel wie bei jeder Webshop-Anbindung. Der Unterschied liegt darin, wie die Verbindung hergestellt wird, und davon handelt der Rest.

Push und Pull in einfachen Worten

Ein System kann nachfragen, ob etwas Neues da ist (Pull oder Polling), etwa alle zehn Minuten. Es kann auch einen Hinweis bekommen, sobald etwas passiert (Push). Ein solcher Hinweis heißt oft Webhook: Das System sendet selbst eine Nachricht an eine Adresse, die Sie angeben ³. Nachfragen ist einfach, aber Sie hängen immer etwas hinterher und fragen oft ins Leere. Ein Hinweis ist schneller, doch Ihre Seite muss die Nachricht empfangen und verarbeiten können. Viele Anbindungen nutzen beides.

API, Plugin, CSV-Import oder fertige Integration?

Alle vier bringen Daten von A nach B. Sie unterscheiden sich in Tempo, Flexibilität und darin, wie viel Arbeit Sie damit haben.

Eine fertige Integration ist meist selbst eine API-Anbindung: Der Anbieter hat die Arbeit erledigt, Sie müssen nichts bauen. Das ist die normale Wahl, solange das gewünschte System auf der Liste steht. Siehe auch den Unterschied zwischen Plugin, Integrationsplattform und eigener API.

Was kann schiefgehen?

• Limits. Eine API erlaubt nur eine bestimmte Anzahl Anfragen pro Zeitraum. Überschreiten Sie sie, erhalten Sie die Meldung "zu viele Anfragen" (HTTP 429) und müssen warten ². Bei großen Katalogen muss Ihre Anbindung das berücksichtigen.
• Zugang. Jede API will wissen, wer anfragt, meist mit Schlüssel oder Token. Schlüssel laufen ab, werden widerrufen oder gelangen nach außen. Wer verwaltet sie?
• Versionen. Eine API ändert sich. Eine alte Version verschwindet irgendwann, und eine nicht angepasste Anbindung hört auf zu funktionieren.
• Fehler. Eine Anfrage kann an einer Störung, einem Time-out oder falschen Daten scheitern. Eine gute Anbindung versucht es erneut und zeigt, was nicht geklappt hat, statt still zu scheitern.
• Daten, die nicht passen. Kategorien, Steuercodes und Attribute heißen überall anders. Jemand muss sie abgleichen.

So beurteilen Sie einen Anbieter

• Gibt es eine öffentliche Dokumentation, die Sie selbst lesen können?
• Gehen Daten in eine Richtung oder in beide, und wie oft?
• Was passiert bei einem Fehler, und sehen Sie das selbst?
• Wer passt die Anbindung an, wenn die Gegenseite ihre API ändert?
• Welche Limits gelten für Ihr Paket?

Selbst bauen oder einen Anbieter nutzen?

Selbst bauen lohnt sich, wenn Sie einen Prozess haben, den niemand standardmäßig unterstützt, etwa ein eigenes ERP oder eine individuelle Kasse, und wenn ein Entwickler die Lösung auch nach der Übergabe pflegt. Rechnen Sie mit Bauzeit, Tests, Fehlerbehandlung und Anpassungen bei jeder API-Änderung.

Ein Anbieter ist klüger bei bekannten Kanälen wie Marktplätzen oder Lieferanten. Diese APIs sind für Sie nicht einzigartig, also teilen Sie die Arbeit lieber mit anderen. Auch die Kombination gibt es: eine fertige Integration für die Standardkanäle und eigene Software für alles andere.

Was StoreLinkr bietet: Integrationen und eine eigene API

StoreLinkr hat zwei Seiten, und Sie können beide kombinieren.

Fertige Integrationen

Die Übersicht der Integrationen listet die Marktplätze, Webshops, Lieferanten und Lagersysteme, die StoreLinkr bereits anbindet. Dafür müssen Sie keine API-Anbindung bauen. Steht ein System nicht darin, ist es nicht verfügbar; fragen Sie dann zuerst nach, was möglich ist. Siehe auch Onlineshop anbinden.

Die E-Commerce-API

Für alles, was darüber hinausgeht, hat StoreLinkr eine RESTful E-Commerce-API (die Seite ist auf Englisch). Ihre Entwickler können damit Produkte auslesen und aktualisieren, Bestandsänderungen durchführen sowie Bestellungen abrufen und verarbeiten. Zusätzlich unterstützt StoreLinkr Webhooks, sodass Ihr System bei einer neuen Bestellung oder Bestandsänderung einen Hinweis bekommt, statt ständig nachzufragen. Für den Datenaustausch sind JSON, XML und CSV möglich. Die öffentliche Dokumentation finden Sie unter api.storelinkr.com.

Ihre Marktplatz- und Webshop-Anbindungen funktionieren weiter, während Ihre eigene Software per API darauf aufsetzt. Welche Limits gelten, hängt von Ihrem Paket und der Nutzung ab. Fragen Sie nach, bevor Sie etwas Aufwendiges bauen, und sehen Sie die Preise.

Häufige Fragen