Skip to main content
PUT
Import and update products
Cet endpoint importe vos produits dans votre compte Kameleoon. C’est la méthode préférée pour importer votre catalogue si vous avez plus de 50K produits. Kameleoon recommande fortement d’utiliser cet endpoint également pour mettre à jour la liste des produits et leurs propriétés, plutôt que de réimporter complètement votre catalogue quotidiennement.
Si vous utilisez exclusivement cet endpoint pour importer votre catalogue, assurez-vous que toutes les catégories ont d’abord été importées via l’endpoint d’import de catégories. Tout produit sans catégorie connue sera ignoré lors du processus d’import.
Les données sont envoyées sous forme de chaîne JSON dans le corps de la requête.

Limite de débit

  • La limite de requêtes API (Rate Limit) est fixée à 40 requêtes par minute, avec un maximum d’1 requête toutes les 1,5 secondes.
  • La limite de poids des requêtes API (Weight Limit) est plafonnée à 35 mégaoctets par requête.

Liste des paramètres de requête

L’objectif du webhook est de notifier le développeur une fois qu’une requête est terminée. Une fois que tous les produits de l’appel API ont été importés et sont entièrement disponibles, Kameleoon envoie une requête POST au webhook désigné.Exemple d’une requête réussie :
Exemple d’une requête échouée :

Liste des paramètres pour l’objet items

Pour mettre à jour uniquement certains produits, fournissez toutes les valeurs des paramètres obligatoires pour chaque produit dans la requête. Si une propriété obligatoire d’un produit est omise, Kameleoon ignore ce produit lors de l’import et n’apporte aucune modification à la base de données. Par exemple, pour mettre à jour uniquement le prix d’un produit, incluez tous ses paramètres obligatoires, tels que categories, name, picture et available.Pour les propriétés non obligatoires, Kameleoon supprime toute valeur omise de la base de données.

Liste des paramètres pour l’objet locations

Utilisez l’objet locations pour fournir des informations sur les prix, les stocks et d’autres informations spécifiques à un lieu lorsque vous avez plusieurs lieux. Passez l’objet locations à l’intérieur de l’objet items des produits.

Liste des paramètres pour l’objet delivery_types

Liste des paramètres pour l’objet Params

L’objet params vous permet de spécifier des valeurs de paramètres personnalisées pour l’article. Passez l’objet params à l’intérieur de l’objet items des produits.

Liste des paramètres pour l’objet Fashion

L’objet fashion vous permet de spécifier des informations supplémentaires sur les articles de mode. Passez l’objet fashion à l’intérieur de l’objet items des produits.

Exemple de requête JSON

Corps

application/json
shop_id
string
requis

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
requis

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[]
requis

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.

Réponse

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.