Was ist dieShopware Admin-API?
Die Schnittstelle, über die andere Systeme und Skripte mit den Daten Ihres Shops arbeiten.
Direkt zur Anfrage
Sprechen wir über Ihr Projekt.
Erst prüfen wir, ob das Vorhaben zu Ihrem Geschäftsmodell passt. Dann folgt ein Vorschlag mit Phasen und Aufwand.
Shopware-Projekt besprechen oder anrufen: +49 151 1576 5566Die Admin-API ist laut Shopware die Schnittstelle für Integrationen, Automatisierung, Datenabgleich sowie Importe und Exporte, mit Lese- und Schreibzugriff auf jede Entität. Ihr Sync-Endpunkt legt viele Datensätze in einer einzigen Anfrage an oder aktualisiert sie. So lassen sich Massenänderungen erledigen, ohne dass dauerhafter Code im Shop zurückbleibt.
- Die Admin-API passt, wenn ein anderes System Daten im Shop lesen oder schreiben soll.
- Der Sync-Endpunkt ändert viele Datensätze in einer Anfrage.
- Auch Shopware-Apps arbeiten über die Admin-API mit den Daten des Shops.
- Was bei jeder Bestellung im Shop passieren muss, etwa eine eigene Preisregel im Warenkorb, braucht ein Plugin oder eine App.
Auf dieser Seite
Wofür Ihnen die Shopware Admin-API ein eigenes Plugin erspart
Typisch ist die Anbindung von Warenwirtschaft, PIM oder Versand. Bestände, Preise und Bestellstatus wandern über die Schnittstelle, und im Shop bleibt kein zusätzlicher Code zurück, der bei Updates gepflegt werden muss.
Die Grenze liegt dort, wo etwas bei jeder Bestellung oder jedem Seitenaufruf im Shop passieren muss. Das kann keine Schnittstelle von außen leisten, dafür braucht es ein Plugin oder eine App.
Wie der Sync-Endpunkt der Admin-API Massenänderungen sicher macht
Ein Beispiel aus unserer Arbeit für einen Kinderwagen-Hersteller: 23 Produktvarianten sollten eine EAN für Google Shopping bekommen. In der Oberfläche brach die Pflege nach zwei Einträgen mit einer Zeitüberschreitung ab, und der CSV-Import meldete Fehler, also haben wir die übrigen 21 über die Admin-API gesetzt. Ein Plugin brauchte es dafür nicht.
Wichtig ist bei solchen Läufen die Reihenfolge: erst den Bestand lesen, dann nur das eine Zielfeld schreiben und danach jeden einzelnen Datensatz gegenprüfen. Gesucht wird der Sync-Endpunkt auch als Shopware Sync API.
Warum Shopware-Apps über die Admin-API arbeiten und was Sie davon haben
Ein Plugin läuft im Shopware-Prozess und greift direkt auf die Datenbank zu. Eine App bleibt außerhalb, beschreibt sich über eine Datei namens manifest.xml, bekommt Ereignisse per Webhook mitgeteilt und arbeitet über die Admin-API mit den Daten.
Die Datenbankstruktur des Shops kann eine App deshalb nicht verändern. Dafür läuft sie auch in der Shopware Cloud, in der Plugins laut Shopware nicht unterstützt werden.
Häufige Fragen
Brauche ich für eine Massenänderung ein Plugin?
Meistens nicht, dafür reicht die Admin-API, zum Beispiel der Sync-Endpunkt. Wichtig ist nur, dass vorher der Bestand gelesen und hinterher jeder Datensatz gegengeprüft wird.
Wann genügt die Shopware Admin-API statt eines eigenen Plugins?
Wenn ein anderes System Daten im Shop lesen oder schreiben soll und keine Regel im Ablauf des Shops selbst greifen muss.
Kann eine App die Datenbankstruktur des Shops ändern?
Nein. Apps arbeiten über die Admin-API und können die Datenbankstruktur nicht verändern, Plugins können es.
Begriffe, die Sie im selben Zusammenhang kennen sollten
Shopware-5-Plugin · SaaS (Software as a Service) · Zum KI-Glossar A-Z
Welche Änderung in Ihrem Shop pflegen Sie heute noch Datensatz für Datensatz von Hand?