Importer et mettre à jour des produits

curl --request PUT \
  --url https://api.example.com/endpoint

import requests

url = "https://api.example.com/endpoint"

response = requests.put(url)

print(response.text)

const options = {method: 'PUT'};

fetch('https://api.example.com/endpoint', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/endpoint",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/endpoint"

	req, _ := http.NewRequest("PUT", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/endpoint")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/endpoint")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body

PUT

endpoint

Importer et mettre à jour des produits

curl --request PUT \
  --url https://api.example.com/endpoint

import requests

url = "https://api.example.com/endpoint"

response = requests.put(url)

print(response.text)

const options = {method: 'PUT'};

fetch('https://api.example.com/endpoint', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/endpoint",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/endpoint"

	req, _ := http.NewRequest("PUT", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/endpoint")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/endpoint")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body

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. Nous recommandons 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.

Requête HTTP

PUT https://api.products.kameleoon.com/import/products

Liste des paramètres de requête

Paramètre	Type	Requis	Description
`shop_id`	String	Oui	Votre Store Key. Vous pouvez la trouver dans Recommendations > Settings > Store settings dans l’application Kameleoon. Vous pouvez également contacter votre Customer Success Manager pour obtenir la clé.
`shop_secret`	String	Oui	Votre Secret Key. Vous pouvez la trouver dans Recommendations > Settings > Store settings dans l’application Kameleoon. Vous pouvez également contacter votre Customer Success Manager pour obtenir la clé.
`items`	List	Oui	Une liste d’articles produits. Trouvez dans ce tableau les paramètres requis pour `items`
`webhook`	String	Non	L’URL Webhook est l’endroit où une requête POST sera envoyée à la fin de l’import.

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, une requête POST sera envoyée au webhook désigné.Exemple d’une requête réussie :

{
	"status": "success"
}

Exemple d’une requête échouée :

{
	"status": "error", 
	"message": "MESSAGE"
}

Liste des paramètres pour l’objet `items`

Si vous souhaitez mettre à jour uniquement certains produits, vous devez fournir toutes les valeurs des paramètres obligatoires pour chaque produit dans la requête. Si l’une des propriétés obligatoires d’un produit est omise, le produit sera ignoré lors de l’import et aucune modification ne sera apportée à notre base de données. Par exemple, si vous souhaitez mettre à jour uniquement le prix d’un produit, vous devez inclure tous ses paramètres obligatoires, tels que category, name, picture, tags, etc.Pour les propriétés non obligatoires, toute valeur omise entraînera la suppression de ces propriétés de notre base de données.

Paramètre	Type	Requis	Description
`id`	String (longueur max 64)	Oui	Un ID unique attribué à l’article
`group_id`	String (longueur max 64)	Optionnel	L’ID associé au groupe d’articles
`name`	String (longueur max 255)	Oui	Le nom de l’article
`price`	Float (doit être positif)	Oui	Le prix de l’article. Pour fournir des prix dans plusieurs lieux, utilisez plutôt l’objet locations.
`oldprice`	Float (doit être positif)	Optionnel	Le prix précédent de l’article
`currency`	String	Oui	La devise dans laquelle le champ price a été spécifié
`url`	String	Oui	Une URL à associer à l’article
`picture`	String	Oui	Une URL contenant une image de l’article
`available`	Boolean	Oui	Indique si l’article est disponible à l’achat. Utilisez l’endpoint update products pour le mettre à jour ultérieurement
`categories`	Array of strings	Oui	Chaque chaîne représente un ID de catégorie auquel ce produit appartient.
`locations`	Array	Optionnel	Tableau des prix de l’article à différents endroits. Trouvez dans ce tableau les paramètres requis pour `locations`
`accessories`	Array of strings	Optionnel	Contient les IDs de produits des accessoires associés à l’article
`seasonality`	Array of integers	Optionnel	Représente les mois de l’année (Janvier=1, Décembre=12) où vous souhaitez promouvoir cet article
`brand`	String	Optionnel	Le nom de la marque de l’article
`barcode`	Integer	Optionnel	Une valeur de code-barres pour l’article
`price_margin`	Integer	Optionnel	La marge de prix pour l’article
`tags`	Array of strings	Optionnel	Une liste de mots-clés que vous souhaitez associer à l’article
`is_child`	Boolean	Optionnel	Indique si cet article est un enfant d’un autre article
`is_fashion`	Boolean	Optionnel	Indique si cet article est un article de mode
`is_new`	Boolean	Optionnel	Indique si cet article est un nouvel article
`fashion`	Object	Optionnel	Définit plusieurs paramètres supplémentaires pour les articles de mode. Trouvez dans ce tableau les paramètres requis pour `fashion`
`stock_quantity`	Integer	Optionnel	La quantité de l’article en stock
`type_prefix`	String	Optionnel	Un préfixe pour distinguer le type d’article
`model`	String	Optionnel	Le nom du modèle de l’article
`params`	Object	Optionnel	Ajoutez des paramètres personnalisés. Trouvez dans ce tableau les paramètres requis pour `params`
`merchant`	String	Optionnel	Le marchand que vous souhaitez associer à l’article
`rating`	Integer	Optionnel	Une valeur entre 1 et 5. La note utilisateur que vous souhaitez attribuer à l’article
`leftovers`	String	Optionnel	Une description du stock restant. Par exemple, “one” représente un produit disponible en une seule unité, “few” représente un produit en quantités limitées (jusqu’à 10 unités), et “lot” représente un produit disponible en quantités de 10 unités ou plus
`creation_date`	String	Optionnel	Doit être au format `yyyy-mm-dd`. C’est la date de création de l’article

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.

Paramètre	Type	Requis	Description
`location`	String	Oui	Le lieu pour lequel vous souhaitez spécifier un prix. Ce champ est requis si le champ locations est fourni.
`price`	Float (doit être positif)	Optionnel	Le prix à cet endroit.
`oldprice`	Float (doit être positif)	Optionnel	Le prix précédent de l’article (par exemple, le prix régulier d’un article en solde).
`stock_quantity`	Int (doit être positif)	Optionnel	La quantité de l’article en stock.
`sizes`	Array of Strings	Optionnel	Une liste d’options de taille pour l’article.
`weight`	Int (doit être positif)	Optionnel	Le poids de l’article.
`delivery_types`	Object	Optionnel	Indique la disponibilité de l’article. Trouvez dans ce tableau les paramètres requis pour `delivery_types`

Liste des paramètres pour l’objet `delivery_types`

Paramètre	Type	Requis	Description
`store`	Int (doit être positif)	Oui	Nombre d’articles disponibles en magasin
`delivery`	Int (doit être positif)	Oui	Nombre d’articles disponibles à la livraison
`delivery`	Int (doit être positif)	Oui	Nombre d’articles disponibles dans l’entrepôt

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.

Paramètre	Type	Requis	Description
`name`	String	Oui	Le nom du paramètre
`value`	Array of Strings	Oui	Tableau de valeurs pour le paramètre
`unit`	String	Optionnel	Unité de mesure pour les valeurs.

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.

Paramètre	Type	Requis	Description
`gender`	String	Optionnel	Un genre à associer à l’article. Par exemple, “m”, “f” ou “female”.
`sizes`	Array of Strings	Optionnel	Liste des tailles pour l’article.
`type`	String	Oui	Le type d’article de mode. Par exemple, “jacket”.

Exemple de requête JSON

{
    "id": "myID", // String (max 64). Required
    "group_id": "myGroup", // String (max 64). Optional
    "name": "myItem", // String (max 255). Required
    "price": "1", // Float (positive). Required
    "oldprice": "2", // Float (positive). Optional
    "currency": "USD", // Currency code: USD, EUR. Required.
    "url": "https://example.com/product", // String (URL). Required
    "picture": "https://example.com/product/image.png", // String (URL). Required
    "available": true, // Boolean (true, false). Required
    "categories": ["ID1", "ID2", ...], // Array of categories IDs. Required.
    "locations": [ 
    {
        "location": "USA",
        "delivery_types": {
            "store": 10,
            "stock": 50  }
    },
    {
        "location": "CAN",
        "price": 60
    }
    ], // Array of prices in locations. See below. Optional
    "accessories": ["ID", "ID", ...], // Array of product IDs. Optional
    "seasonality": [1, 2, ...], // Array of integers (months: 1-12). Optional
    "brand": "...", // String. Optional
    "barcode": "...", // String. Optional
    "price_margin": "...",// Integer. Optional
    "tags": ["TAG1", "TAG2", ...], // Array of strings. Optional
    "is_child": false, // Boolean (true, false). Optional
    "is_fashion": true, // Boolean (true, false). Optional
    "is_new": false, // Boolean (true, false). Optional
    "fashion": {
        "gender": "m",
        "sizes": ["48", "50", "52"],
        "type": "jacket"
    }, // Object. See below. Optional
    "stock_quantity": 60, // Int (positive). Optional
    "type_prefix": "...", // String. Optional
    "model": "Widget 3000", // String. Optional
    "params": [ 
    {
        "name": "Param 1",
        "value": ["bluetooth", "wi-fi"]
    }, 
    {
        "name": "Param 2",
        "value": [23]
    }
    ], // Array of params data. See below. Optional
    "merchant": "...", // String. Optional
    "rating": 4, // Integer (1-5). Optional
    "leftovers": "one", // String (one, few, lot). Optional
    "creation_date": "...", // String. Optional. Format yyyy-mm-dd,
}

Importer des commandes

Supprimer des produits

⌘I

​Limite de débit

​Requête HTTP

​Liste des paramètres de requête

​Liste des paramètres pour l’objet items

​Liste des paramètres pour l’objet locations

​Liste des paramètres pour l’objet delivery_types

​Liste des paramètres pour l’objet Params

​Liste des paramètres pour l’objet Fashion

​Exemple de requête JSON

Limite de débit

Requête HTTP

Liste des paramètres de requête

Liste des paramètres pour l’objet `items`

Liste des paramètres pour l’objet `locations`

Liste des paramètres pour l’objet `delivery_types`

Liste des paramètres pour l’objet `Params`

Liste des paramètres pour l’objet `Fashion`

Exemple de requête JSON