API-Integration ist die Verbindung von zwei oder mehr Softwaresystemen über eine Programmierschnittstelle, kurz API, sodass sie automatisch Daten austauschen und Aktionen auslösen. Ein System sendet eine strukturierte Anfrage, das andere antwortet mit Daten oder bestätigt eine Änderung, ganz ohne manuellen Export und Import.
Ein Vertrag zwischen Systemen
Eine API ist ein veröffentlichtes Regelwerk für die Kommunikation mit einer Software. Es legt fest, welche Anfragen erlaubt sind, welche Informationen jede Anfrage enthalten muss und wie die Antwort aussieht. Weil beide Seiten demselben Vertrag folgen, können sie zusammenarbeiten, selbst wenn sie von verschiedenen Unternehmen in verschiedenen Programmiersprachen entwickelt wurden.
Eine Integration ist die funktionierende Verbindung, die auf diesem Vertrag aufbaut. Sie legt fest, welche Daten in welche Richtung und wie oft fließen und was bei einem Fehler passiert.
Anfragen, Antworten und Ereignisse
- Eine Leseanfrage fordert Daten an, zum Beispiel den aktuellen Preis und Bestand eines Produkts.
- Eine Schreibanfrage ändert Daten, zum Beispiel indem sie einen neuen Preis für ein Produkt setzt.
- Eine Antwort liefert das Ergebnis, meist in einem strukturierten Textformat wie JSON, mit einem Statuscode für Erfolg oder Fehler.
- Ein Webhook kehrt den Ablauf um: Ein System benachrichtigt ein anderes in dem Moment, in dem ein Ereignis eintritt, etwa eine neue Bestellung, statt auf eine Anfrage zu warten.
Die meisten APIs verlangen eine Authentifizierung, typischerweise einen Schlüssel oder ein Token, das den Aufrufer identifiziert und begrenzt, was er tun darf. Schlüssel sollten sicher gespeichert und nur mit den Berechtigungen versehen werden, die die Integration braucht.
Wo APIs im E-Commerce vorkommen
Moderne Shops laufen mit mehreren verbundenen Tools. Ein typisches Setup verknüpft etwa die Shop-Plattform mit einem Zahlungsanbieter, einem Versanddienst, einer Buchhaltungssoftware, einem Marktplatzkanal, einem E-Mail-Tool und einem Pricing-Tool. Jede Verbindung ist eine Integration, und gemeinsam halten sie das Geschäft ohne ständige manuelle Dateneingabe am Laufen.
Preise gehören zu den sensibelsten Werten, die über diese Verbindungen fließen. Ein an einer Stelle gesetzter Preis muss womöglich den Online-Shop, ein Marktplatzangebot und einen Produkt-Feed für Shopping-Anzeigen erreichen. Hinkt eine dieser Kopien hinterher, sehen Kunden an verschiedenen Orten unterschiedliche Preise, und Werbeplattformen lehnen womöglich Angebote ab, deren Feed-Preis nicht mit der Landingpage übereinstimmt.
Ein Beispiel für einen Ablauf zur Preisaktualisierung
Stellen Sie sich als Beispiel einen Shop für Kamerazubehör vor, der jeden Morgen seine Preise prüft. Um 07:00 berechnet ein Pricing-Tool neue Preise für 120 Produkte. Es sendet Schreibanfragen über die API der Shop-Plattform, eine pro Produkt oder gebündelt, sofern die API das erlaubt. Der Shop antwortet bei 118 Produkten mit Erfolgscodes und bei 2 mit Fehlern, weil es diese nicht mehr gibt. Das Tool protokolliert die Fehler, und eine Mitarbeiterin entfernt die alten Produkte aus der Preisliste.
Ohne die Integration müsste jemand 120 Preise von Hand übertragen, eine langsame Aufgabe mit echtem Risiko für Tippfehler. Mit ihr dauert die Arbeit Minuten und jede Änderung wird protokolliert. Die Shop-Integration von BlackAha nutzt eine solche Verbindung, um Preise mit einem verbundenen Shop zu synchronisieren.
Die Wahl zwischen API, Feed und manuellen Dateien
APIs sind nicht der einzige Weg, Daten zu übertragen. Produkt-Feeds, also nach Zeitplan veröffentlichte Dateien, eignen sich für große Kataloge, die sich einige Male am Tag ändern. Tabellenimporte bleiben für einmalige Migrationen nützlich. Eine API ist die bessere Wahl, wenn Änderungen schnell, gezielt oder bestätigt sein müssen, etwa wenn ein einzelner Preis innerhalb von Minuten aktualisiert werden soll und Sie wissen wollen, dass es geklappt hat.
Was schiefgehen kann
- Abruflimits: Plattformen begrenzen, wie viele Anfragen ein Aufrufer pro Minute senden darf, daher müssen Massenaktualisierungen getaktet werden.
- Versionswechsel: Anbieter stellen alte API-Versionen ein, und Integrationen müssen rechtzeitig aktualisiert werden.
- Feldfehler: Der Aktionspreis eines Systems landet womöglich im regulären Preis eines anderen, wenn Felder falsch zugeordnet sind.
- Teilausfälle: Manche Anfragen gelingen, andere scheitern, und die Daten bleiben halb aktualisiert.
- Stille Fehler: Eine Integration, die ohne Warnung stoppt, kann veraltete Preise tagelang live lassen.
Zwei Schutzmaßnahmen decken das meiste davon ab. Erstens: Protokollieren Sie jede Anfrage und Antwort, damit sich Probleme nachverfolgen lassen. Zweitens: Überwachen Sie die Ergebnisse, etwa indem Sie nach jedem Aktualisierungslauf eine Stichprobe der Live-Preise mit den beabsichtigten vergleichen.
Eine zuverlässige Integration planen
- Legen Sie für jedes Feld fest, welches System die maßgebliche Quelle ist, etwa für Preis, Bestand oder Produkttitel.
- Ordnen Sie Felder sorgfältig zu, einschließlich Währung, Steuereinstellungen und Variantenkennungen.
- Testen Sie in einem Staging-Shop oder mit wenigen Produkten, bevor Sie den gesamten Katalog einschalten.
- Setzen Sie Grenzen, etwa eine maximale Preisänderung pro Aktualisierung, damit sich eine fehlerhafte Eingabe nicht ausbreitet.
- Bestimmen Sie eine verantwortliche Person, die Fehlermeldungen erhält und die Protokolle prüft.
Klare Zuständigkeit ist so wichtig wie der Code. Verlässt die Person, die eine Integration eingerichtet hat, das Unternehmen, erspart eine kurze schriftliche Beschreibung, was sie tut, welche Schlüssel sie nutzt und wo ihre Protokolle liegen, der nächsten Person viel Rätselraten.
Das Wichtigste in Kürze
- API-Integration verbindet Systeme über eine festgelegte Schnittstelle, sodass sie automatisch Daten austauschen.
- Im E-Commerce übertragen Integrationen Preise, Bestände, Produkte und Bestellungen zwischen Shops und Tools.
- Webhooks melden Ereignisse sofort, während API-Anfragen Daten bei Bedarf abrufen oder senden.
- Abruflimits, Feldfehler und stille Ausfälle sind die häufigsten Probleme.
- Bestimmen Sie für jedes Feld eine maßgebliche Quelle, testen Sie zuerst an einer kleinen Auswahl und überwachen Sie jeden Aktualisierungslauf.
Häufig gestellte Fragen
Wofür steht API?
API steht für Application Programming Interface, also Programmierschnittstelle. Sie ist ein festgelegter Weg, über den eine Software Daten oder Aktionen von einer anderen anfordert.
Brauche ich einen Entwickler, um eine API-Integration einzurichten?
Nicht immer. Viele Tools bieten fertige Konnektoren, bei denen Sie sich anmelden oder einen Schlüssel einfügen und Einstellungen wählen. Individuelle Integrationen zwischen Systemen ohne fertigen Konnektor erfordern meist Entwicklungsarbeit.
Was ist der Unterschied zwischen einer API und einem Webhook?
Bei einem API-Aufruf fragt ein System ein anderes nach Daten oder sendet eine Änderung, wann es will. Bei einem Webhook sendet das andere System automatisch eine Benachrichtigung, sobald ein Ereignis eintritt. Viele Integrationen nutzen beides.
Ist eine API-Integration sicher?
Sie kann es sein, wenn Schlüssel geheim bleiben, Berechtigungen auf das Nötige beschränkt und Verbindungen verschlüsselt sind. Prüfen Sie, welche Integrationen Zugriff auf Ihren Shop haben, und entfernen Sie solche, die Sie nicht mehr nutzen.
Verwandte Begriffe
In BlackAha Store Platform Integration hilft Ihnen, Ihren Shop zu verbinden und Produktpreise automatisch zu synchronisieren.