Der Bereich Shopware Labs ist die Plattform für alle Entwickler. Hier findet man technische Dokumentationen und zahlreiche Tipps und Tricks rund um das Thema Programmieren. In dieser Rubrik stellen außerdem die Entwickler der shopware AG neue und experimentelle Lösungsansätze vor. Neue Funktionen, die in dieser Rubrik bereitgestellt werden, sind teilweise auch für zukünftige Releases geplant. Die Funktionen können dann ohne Programmierkenntnisse zukünftig direkt im Shopware Backend konfiguriert werden oder werden über Plugins bereitgestellt. Informationen über neue, geplante Funktionen finden Sie in unserer Roadmap.
Bitte beachten Sie, dass die hier bereitgestellten Lösungsansätze nicht offiziell supportet werden und nur eingebaut werden sollten, sofern Sie über das entsprechende, technische Wissen verfügen.
Erste Schritte
0 Kommentare| ab Version: | 3.0 |
Inhaltsverzeichnis
Aktuelle Version
Shopware API 3.0 vom 23.06.2009
Aufbau der Verzeichnisstruktur
Mit der Shopware API haben Sie die Möglichkeit eigene Im- und Exporte und Anbindungen an Warenwirtschaftssysteme zu realisieren.
Die API befindet sich im Ordner /engine/connectors/api
Ordnerstruktur:
- /convert/ - Hier liegen Konverter für den Im- und Export von XML und CSV-Daten
- /export/ - shopware.php - Basis-Klasse für alle Funktionen die mit dem Export von Daten zutun haben
- /import/ - shopware.php - Basis-Klasse für alle Funktionen die mit dem Import von Daten zutun haben
- /sample/ - Verschiedene Beispiele für den Einsatz der API
- api.php - Basisklasse
Entwickler-Informationen
Aufruf-Möglichkeiten
Hinweis: Bitte fügen Sie die nachfolgenden Zeilen an den Anfang Ihrer Scripte ein um eine Absicherung über den Shopware API-Schlüssel zu gewährleisten.
//Beispiel zur Absicherung des API-Calls über einen eindeutigen //API - Schlüssel - Kann über Einstellungen > Schnittstellen > API //im Backend generiert werden. if ($_REQUEST["sAPI"]!=$api->sSystem->sCONFIG["sAPI"]){ exit; }
Den API-Schlüssel können Sie in den Grundeinstellungen erzeugen / ändern.
| HTTP | Sie können Ihr Script manuell per HTTP aufrufen. Dies kann ggf. durch Ihre Warenwirtschaft
automatisiert werden. Beispiel: http://www.ihrshop.de/engine/connectors/api/myimport/import.php?sAPI=IHR_API_KEY |
|---|---|
| Cronjob | Natürlich können Sie auch einen Cronjob einrichten, der Ihre Scripte periodisch aufruft. Bitte kontaktieren
Sie hierzu Ihren Provider. |
| Backend | Um Ihr Script direkt über das Shopware Backend aufrufen zu können, müssen Sie einen Verweis
in die Shopware Menü-Struktur einfügen. Beispiel: INSERT INTO `s_core_menu` ( `id` , `parent` , `hyperlink` , `name` , `onclick` , `style` , `class` , `position` , `active` , `ul_properties` ) VALUES ( NULL , '23', 'http://meinshop.de/engine/connectors/api/myimport/import.php', 'Import starten', '', 'background-position: 5px 5px;', 'ico2 computer', '-4', '1', '' ); Hiermit würde der Eintrag "Einstellungen > Import starten" in die Menüstruktur eingefügt |
Daten-Zugriff
Import
- Sie können die Daten direkt via FTP in das Filesystem des Servers schreiben und dann auf diese zugreifen
- Alternativ können Sie das Import-Script via Http aufrufen und die Daten per POST übergeben
- Bei einer Backend-Integration Ihres Import-Scripts können Sie natürlich auch ein Datei-Upload-Feld
anbieten, hier könnten die zu importierenden Daten dann manuell hochgeladen werden
Export
- Direkte Ausgabe der Daten im Browser (Potentiell unsicher)
- Schreiben der Daten ins Filesystem des Server und Abruf über FTP
- Verschicken der Daten per eMail
Was gibt es zu beachten
CSV oder XML?
Das Parsen von XML-Dateien benötigt viel Systemressourcen, deshalb ist bei größeren Importen generell zu einem einfachen Datei-Format zu raten (Plaintext/CSV). Alternativ können Sie Ihren XML-Import in mehrere, kleinere Dateien splitten.
Artikel-PDF erstellen
Artikel bewerten
Kommentare:
Artikel kommentieren
Weitere interessante Artikel:
Bestell-Nr.: 74114_
Lieferzeit ca. 5 Tage
Preise inkl. gesetzlicher
MwSt. zzgl. Versandkosten*
Preise inkl. gesetzlicher
MwSt. + Versandkosten*
Kategorien:
