API Integration Guide
Diese Anleitung gilt für Shops, die du in Libers Suite per API verbindest: Shopware 6, Wix, Squarespace, PrestaShop, BigCommerce, Ecwid und OpenCart. Du holst Zugangsdaten in deinem Shop-Admin, trägst sie in Libers Suite ein und startest den Sync selbst. Danach arbeitest du wie bei jedem anderen Shop: Produkte, Knowledge Packs, veröffentlichen.
Magento hat eine eigene Anleitung. WooCommerce ebenfalls, über das WordPress-Plugin.
Zugangsdaten aus dem Shop
Jedes System braucht andere Felder. Unten steht, was du wo findest.
In Libers Suite speichern
Speichern legt nur die Verbindung an. Es kommen noch keine Produkte.
Produkte holen
Du startest Synchronisieren auf der Shop-Karte, wenn du soweit bist.
Schritt 1: Zugangsdaten vorbereiten
Öffne den Admin deines Shops und hole genau die Felder, die Libers Suite für deine Plattform zeigt. Springe zu deinem System:
Shopware 6
Shop-URL, Client-ID und Secret. Im Shopware-Admin: Einstellungen → System → Integrationen. Eine Integration anlegen und die beiden Schlüssel kopieren.
Wix
Shop-URL, API Key und Site ID. Beides holst du in deinem Wix-Konto. Ohne Site ID schlägt der Import fehl.
Squarespace
Shop-URL und API Key. Du brauchst den Commerce Advanced Plan. Den Key findest du unter Settings → Advanced → Developer API Keys.
PrestaShop
Shop-URL und Webservice-Key. Zuerst Webservices einschalten: Erweiterte Einstellungen → Webservice. Dann den Key anlegen und in Libers Suite eintragen.
BigCommerce
Store Hash und Access Token aus dem Store Control Panel. Den Hash liest Libers Suite auch aus der Shop-URL. Ohne Access Token kommt kein Katalog.
Ecwid
Shop-URL, Store ID und Access Token. Eine API-App anlegen unter Apps → API → Create Application.
OpenCart
Shop-URL und API Token. Anlegen unter System → Users → API. Produkte kannst du holen. Knowledge Packs schreibt Libers Suite nicht zurück in den OpenCart-Katalog. Dafür bleibt das Header-Script.
Schritt 2: Shop in Libers Suite verbinden
Öffne das Dashboard unter Shops und lege den Shop an.
Schritt 3: Produkte holen
Auf der Shop-Karte startest du Synchronisieren. Der Lauf holt den Katalog, während du auf der Seite bleibst. Bei einem kleinen Shop reicht das. Bei vielen Produkten dauert das lange oder bricht ab.
Diese Plattformen haben keinen Kategorie-Import wie Magento oder WooCommerce. Du musst nicht den ganzen Katalog holen. Knowledge Packs sind durch deinen Plan begrenzt. Starte mit den Produkten, die in ChatGPT, Perplexity und Google sichtbar werden sollen. Für einen sehr grossen Katalog gibt es den CSV-Import.
Schritt 4: Danach wie bei jedem Shop
Sobald die Produkte in Libers Suite liegen, ist die Plattform kein Sonderfall mehr. Knowledge Packs erstellen, prüfen und veröffentlichen läuft wie in der allgemeinen Dokumentation.
Optional kannst du zusätzlich das Header-Script in den HTML-Kopf deines Themes setzen. Die Produktverbindung läuft über die API, das Script ist Extra-Markup auf den Seiten. Bei OpenCart ist das Script der Weg, Optimierungen auf der Seite sichtbar zu machen, weil Libers Suite den Katalog dort nicht zurückschreibt.
Häufige Fragen
Welche Shops verbindest du so?
Shopware 6, Wix, Squarespace, PrestaShop, BigCommerce, Ecwid und OpenCart. Magento und WooCommerce haben eigene Anleitungen.
Werden die Produkte automatisch synchronisiert?
Nein. Speichern legt nur die Verbindung an. Den Import startest du auf der Shop-Karte mit Synchronisieren.
Was ist, wenn ich mehrere tausend Produkte habe?
Hol nicht den ganzen Katalog. Der Sync läuft, während du wartest, und kann bei einem grossen Katalog abbrechen. Diese Plattformen haben keinen Kategorie-Import. Knowledge Packs sind durch deinen Plan begrenzt. Für sehr grosse Kataloge nutze den CSV-Import.
Schreibt Libers Suite Änderungen zurück in den Shop?
Bei Shopware, Wix, Squarespace, PrestaShop, BigCommerce und Ecwid ja, wenn du veröffentlichst. Bei OpenCart holt Libers Suite nur Produkte. Änderungen erscheinen dort über das Header-Script, nicht im OpenCart-Katalog.