REST API v2.0
Die Booklooker REST API ermöglicht die sichere und einfache Kommunikation mit verschiedenen Booklooker-Schnittstellen. Es besteht die Möglichkeit, Artikel und Aufträge abzufragen, zu ändern, zu stornieren etc. Auch der automatische Import neuer oder geänderter Artikel ist ohne Weiteres möglich.
Diese API basiert auf REST. Zur Benutzung führen Sie bitte die folgenden Schritte durch:
- Sie benötigen Ihren persönlichen API Key, diesen erhalten Sie im Bereich Persönliche Daten
- Benutzen Sie anschließend die Schnittstelle authenticate via HTTP POST und Sie erhalten einen Token, welcher für alle folgenden Aufrufe benötigt wird. Sofern Sie 10 Minuten keine Schnittstelle aufrufen, verfällt der Token und Sie müssen sich erneut authentifizieren.
- Verwenden Sie eine der unten aufgelisteten Schnittstellen. Die Beschreibung jeder Schnittstelle enthält die benötigten Parameter und die möglichen Rückgabewerte.
Zur Kommunikation können verschiedene Programmiersprachen zum Einsatz kommen. Wir stellen Ihnen hier ein Beispiel in PHP zur Verfügung.
Weiterhin bieten wir hier eine OpenAPI Spezifikation an.
Schnittstellen
Schnittstelle | Methode | Beschreibung |
---|---|---|
authenticate | POST | Authentifizierung via API Key |
article | DELETE | Einzelnen Artikel zum Löschen vormerken |
article_list | GET | Liste aller aktiven Artikelnummern |
article_status | GET | Abfragen des Status eines Artikels |
file_import | POST | Upload von Angebots- oder Bilddateien |
file_status | GET | Abfragen des Status einer hochgeladenen Angebotsdatei |
image | DELETE | Einzelne oder alle Bilder eines Artikels löschen |
import_status | GET | Abfragen der Anzahl unverarbeiteter hochgeladener Angebotsdateien |
order | GET | Download aller Bestellungen eines bestimmten Tages |
order_cancel | PUT | Stornieren einer kompletten Bestellung |
order_item_cancel | PUT | Stornieren der Bestellung eines Einzelartikels |
order_message | PUT | Versand einer Nachricht an den Kunden |
order_status | PUT | Setzen des Status einer Bestellung |
Changelog
-
12.11.2024 · Erweiterung der Schnittstelle
file_status
- 14.11.2023 · OpenAPI Spezifikation
-
31.10.2023 · Neue Schnittstelle
image
-
02.02.2022 · Neue Schnittstelle
order_message
- 11.01.2021 · Erste Version