Skip to main content
POST
Import categories
Dieser Endpoint importiert alle Ihre Produktkategorien in Ihr Kameleoon-Konto. Vor dem Hochladen von Produkten müssen Sie eine aktuelle Liste der Kategorien in die Kameleoon-Datenbank hochladen. Die Daten werden als JSON-Zeichenfolge gesendet, die den Anfragetext enthält. Sie müssen alle Kategorien in einer einzigen Anfrage senden.

Liste der Abfrageparameter

Der webhook dient dazu, den Entwickler zu benachrichtigen, sobald eine Anfrage abgeschlossen wurde. Wenn alle im API-Aufruf angegebenen Kategorien importiert und vollständig verfügbar sind, sendet Kameleoon eine POST-Anfrage an den festgelegten Webhook.Kameleoon empfiehlt dringend, den webhook zu verwenden, wenn Sie eine große Anzahl von Kategorien importieren, da deren Verarbeitung in Kameleoon mehrere Minuten dauern kann.Wenn Sie Produkte über den Endpoint zum Importieren von Produkten importieren, stellt die Verwendung des Webhooks sicher, dass alle Kategorien vollständig verarbeitet wurden, bevor mit dem Produktimport begonnen wird. Da die Kategorien zunächst von Kameleoon verarbeitet werden müssen, werden alle Produkte ohne bekannte Kategorie während des Importvorgangs ignoriert.Beispiel für eine erfolgreiche Anfrage:
Beispiel für eine erfolglose Anfrage:

Liste der Parameter für das categories-Objekt

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.

categories
object[]
erforderlich

A list of category objects.

webhook
string

The webhook URL where a POST request is sent upon completion of the import. Recommended for large imports, since processing can take several minutes.

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.