Produkte importieren und aktualisieren
Importieren
Produkte importieren und aktualisieren
Importieren oder aktualisieren Sie Ihren Produktkatalog in Kameleoon mit dem bevorzugten Endpoint für Kataloge mit mehr als 50K Produkten.
PUT
Produkte importieren und aktualisieren
Dieser Endpoint importiert Ihre Produkte in Ihr Kameleoon-Konto. Es ist die bevorzugte Methode zum Importieren Ihres Katalogs, wenn Sie mehr als 50K Produkte haben.
Wir empfehlen dringend, diesen Endpoint auch zum Aktualisieren der Produktliste und ihrer Eigenschaften zu verwenden, anstatt Ihren Katalog täglich vollständig neu zu importieren.
Die Daten werden als JSON-Zeichenfolge im Anfragetext gesendet.
Liste der Parameter für das
Liste der Parameter für das
Verwenden Sie das
Liste der Parameter für das
Liste der Parameter für das
Mit dem params-Objekt können Sie benutzerdefinierte Parameterwerte für den Artikel angeben. Übergeben Sie das
Liste der Parameter für das
Mit dem fashion-Objekt können Sie zusätzliche Informationen zu Modeartikeln angeben. Übergeben Sie das fashion-Objekt innerhalb des Produkt-items-Objekts.
Ratenbegrenzung
- Die Begrenzung für API-Anfragen (Rate Limit) ist auf 40 Anfragen pro Minute festgelegt, mit maximal 1 Anfrage alle 1,5 Sekunden.
- Die Gewichtsbegrenzung für API-Anfragen (Weight Limit) ist auf 35 Megabyte pro Anfrage begrenzt.
HTTP-Anfrage
Liste der Abfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
shop_id | String | Ja | Ihr Store Key. Sie finden ihn in Recommendations > Settings > Store settings in der Kameleoon App. Sie können sich auch an Ihren Customer Success Manager wenden, um den Schlüssel zu erhalten. |
shop_secret | String | Ja | Ihr Secret Key. Sie finden ihn in Recommendations > Settings > Store settings in der Kameleoon App. Sie können sich auch an Ihren Customer Success Manager wenden, um den Schlüssel zu erhalten. |
items | List | Ja | Eine Liste von Produktartikeln. In dieser Tabelle finden Sie die für items erforderlichen Parameter |
webhook | String | Nein | Die Webhook-URL ist der Ort, an den nach Abschluss des Imports eine POST-Anfrage gesendet wird. |
Der Zweck des Beispiel für eine erfolglose Anfrage:
webhook besteht darin, den Entwickler zu benachrichtigen, sobald eine Anfrage abgeschlossen wurde. Sobald alle Produkte im API-Aufruf importiert und vollständig verfügbar sind, wird eine POST-Anfrage an den festgelegten Webhook gesendet.Beispiel für eine erfolgreiche Anfrage:Liste der Parameter für das items-Objekt
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
id | String (max. Länge 64) | Ja | Eine eindeutige ID, die dem Artikel zugewiesen wird |
group_id | String (max. Länge 64) | Optional | Die der Artikelgruppe zugeordnete ID |
name | String (max. Länge 255) | Ja | Der Name des Artikels |
price | Float (muss positiv sein) | Ja | Der Preis des Artikels. Um Preise an mehreren Standorten anzugeben, verwenden Sie stattdessen das locations-Objekt. |
oldprice | Float (muss positiv sein) | Optional | Der vorherige Preis des Artikels |
currency | String | Ja | Die Währung, in der das Preisfeld angegeben wurde |
url | String | Ja | Eine URL, die dem Artikel zugeordnet werden soll |
picture | String | Ja | Eine URL, die ein Bild des Artikels enthält |
available | Boolean | Ja | Gibt an, ob der Artikel zum Kauf verfügbar ist. Verwenden Sie den Endpoint update products, um dies später zu aktualisieren |
categories | Array of strings | Ja | Jede Zeichenfolge stellt eine Kategorie-ID dar, zu der dieses Produkt gehört. |
locations | Array | Optional | Array von Artikelpreisen an verschiedenen Standorten. In dieser Tabelle finden Sie die für locations erforderlichen Parameter |
accessories | Array of strings | Optional | Enthält die Produkt-IDs der zugehörigen Zubehörteile für den Artikel |
seasonality | Array of integers | Optional | Stellt die Monate des Jahres dar (Januar=1, Dezember=12), in denen Sie diesen Artikel bewerben möchten |
brand | String | Optional | Der Markenname des Artikels |
barcode | Integer | Optional | Ein Barcode-Wert für den Artikel |
price_margin | Integer | Optional | Die Preismarge für den Artikel |
tags | Array of strings | Optional | Eine Liste von Schlüsselwörtern, die Sie dem Artikel zuordnen möchten |
is_child | Boolean | Optional | Gibt an, ob dieser Artikel ein Kind eines anderen Artikels ist |
is_fashion | Boolean | Optional | Gibt an, ob dieser Artikel ein Modeartikel ist |
is_new | Boolean | Optional | Gibt an, ob dieser Artikel ein neuer Artikel ist |
fashion | Object | Optional | Definiert mehrere zusätzliche Parameter für Modeartikel. In dieser Tabelle finden Sie die für fashion erforderlichen Parameter |
stock_quantity | Integer | Optional | Die Lagermenge des Artikels |
type_prefix | String | Optional | Ein Präfix zur Unterscheidung des Artikeltyps |
model | String | Optional | Der Modellname des Artikels |
params | Object | Optional | Fügen Sie benutzerdefinierte Parameter hinzu. In dieser Tabelle finden Sie die für params erforderlichen Parameter |
merchant | String | Optional | Der Händler, den Sie dem Artikel zuordnen möchten |
rating | Integer | Optional | Ein Wert zwischen 1 und 5. Die Benutzerbewertung, die Sie dem Artikel zuweisen möchten |
leftovers | String | Optional | Eine Beschreibung des verbleibenden Bestands. Beispielsweise stellt “one” ein Produkt dar, das als einzelne Einheit verfügbar ist, “few” steht für Produkte in begrenzten Mengen (bis zu 10 Einheiten) und “lot” für ein Produkt, das in Mengen von 10 oder mehr Einheiten verfügbar ist |
creation_date | String | Optional | Muss im Format yyyy-mm-dd sein. Dies ist das Erstellungsdatum des Artikels |
Liste der Parameter für das locations-Objekt
Verwenden Sie das locations-Objekt, um Preis-, Bestands- und andere standortspezifische Informationen bereitzustellen, wenn Sie mehrere Standorte haben. Übergeben Sie das locations-Objekt innerhalb des Produkt-items-Objekts.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
location | String | Ja | Der Standort, für den Sie einen Preis angeben möchten. Dieses Feld ist erforderlich, wenn das Feld locations angegeben wird. |
price | Float (muss positiv sein) | Optional | Der Preis an diesem Standort. |
oldprice | Float (muss positiv sein) | Optional | Der vorherige Preis des Artikels (zum Beispiel der reguläre Preis eines Sonderangebots). |
stock_quantity | Int (muss positiv sein) | Optional | Die Lagermenge des Artikels. |
sizes | Array of Strings | Optional | Eine Liste von Größenoptionen für den Artikel. |
weight | Int (muss positiv sein) | Optional | Das Gewicht des Artikels. |
delivery_types | Object | Optional | Gibt die Verfügbarkeit des Artikels an. In dieser Tabelle finden Sie die für delivery_types erforderlichen Parameter |
Liste der Parameter für das delivery_types-Objekt
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
store | Int (muss positiv sein) | Ja | Anzahl der im Geschäft verfügbaren Artikel |
delivery | Int (muss positiv sein) | Ja | Anzahl der zur Lieferung verfügbaren Artikel |
delivery | Int (muss positiv sein) | Ja | Anzahl der im Lager verfügbaren Artikel |
Liste der Parameter für das Params-Objekt
Mit dem params-Objekt können Sie benutzerdefinierte Parameterwerte für den Artikel angeben. Übergeben Sie das params-Objekt innerhalb des Produkt-items-Objekts.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | String | Ja | Der Name des Parameters |
value | Array of Strings | Ja | Array von Werten für den Parameter |
unit | String | Optional | Maßeinheit für die Werte. |
Liste der Parameter für das Fashion-Objekt
Mit dem fashion-Objekt können Sie zusätzliche Informationen zu Modeartikeln angeben. Übergeben Sie das fashion-Objekt innerhalb des Produkt-items-Objekts.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
gender | String | Optional | Ein Geschlecht, das dem Artikel zugeordnet wird. Zum Beispiel “m”, “f” oder “female”. |
sizes | Array of Strings | Optional | Liste der Größen für den Artikel. |
type | String | Ja | Der Typ des Modeartikels. Zum Beispiel “jacket”. |