Skip to main content
PUT
Import and update products
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. Kameleoon empfiehlt dringend, diesen Endpoint auch zum Aktualisieren der Produktliste und ihrer Eigenschaften zu verwenden, anstatt Ihren Katalog täglich vollständig neu zu importieren.
Wenn Sie sich vollständig auf diesen Endpoint zum Importieren Ihres Katalogs verlassen, stellen Sie sicher, dass alle Kategorien zuerst über den Endpoint zum Importieren von Kategorien importiert wurden. Alle Produkte ohne bekannte Kategorie werden während des Importvorgangs ignoriert.
Die Daten werden als JSON-Zeichenfolge im Anfragetext gesendet.

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.

Liste der Abfrageparameter

Der Zweck des 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, sendet Kameleoon eine POST-Anfrage an den festgelegten Webhook.Beispiel für eine erfolgreiche Anfrage:
Beispiel für eine erfolglose Anfrage:

Liste der Parameter für das items-Objekt

Um nur bestimmte Produkte zu aktualisieren, geben Sie alle obligatorischen Parameterwerte für jedes Produkt in der Anfrage an. Wenn eine obligatorische Eigenschaft eines Produkts fehlt, ignoriert Kameleoon dieses Produkt während des Imports und nimmt keine Änderungen an der Datenbank vor. Um beispielsweise nur den Preis eines Produkts zu aktualisieren, geben Sie alle seine obligatorischen Parameter an, wie categories, name, picture und available.Bei nicht obligatorischen Eigenschaften entfernt Kameleoon weggelassene Werte aus der Datenbank.

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.

Liste der Parameter für das delivery_types-Objekt

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.

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.

Beispiel-JSON-Anfrage

Body

application/json
shop_id
string
erforderlich

Store Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.

shop_secret
string
erforderlich

Secret Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.

items
object[]
erforderlich

A list of product items. To update only some properties of a product, you must still include all of that product's mandatory parameters, or the product is ignored during import.

webhook
string

The webhook URL where a POST request is sent upon completion of the import.

Antwort

Import accepted. Verified against a live response on 2026-09-24: this endpoint returns an empty 204 response on success, not a JSON body — the {"status": "success"} shape only applies to the asynchronous webhook callback payload, if a webhook was provided.