Passer au contenu principal
POST
/
endpoint
Importer des catégories
curl --request POST \
  --url https://api.example.com/endpoint
import requests

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

response = requests.post(url)

print(response.text)
const options = {method: 'POST'};

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 => "POST",
]);

$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("POST", url, nil)

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

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

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("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::Post.new(url)

response = http.request(request)
puts response.read_body
Cet endpoint importe toutes vos catégories de produits dans votre compte Kameleoon.

Requête HTTP

POST https://api.products.kameleoon.com/import/categories
Avant de télécharger des produits, il est nécessaire de télécharger une liste à jour des catégories dans notre base de données. Les données sont envoyées sous forme de chaîne JSON qui inclut le corps de la requête. Vous devez envoyer toutes les catégories en une seule requête.

Liste des paramètres de requête

ParamètreTypeRequisDescription
shop_idStringOuiVotre 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_secretStringOuiVotre 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é.
categoriesListOuiUne liste d’objets de catégorie. Trouvez dans ce tableau les paramètres requis pour categories
webhookStringNonL’URL Webhook est l’endroit où une requête POST sera envoyée à la fin de l’import.
Le webhook sert à notifier le développeur une fois qu’une requête est terminée. Lorsque toutes les catégories spécifiées dans l’appel API ont été importées et sont entièrement disponibles, une requête POST sera envoyée au webhook désigné.Nous recommandons fortement d’utiliser le webhook si vous importez un grand nombre de catégories, car leur traitement dans Kameleoon peut prendre plusieurs minutes.Si vous importez des produits via notre endpoint d’import de produits, l’utilisation du webhook garantit que toutes les catégories ont été entièrement traitées avant de lancer l’import de produits. Étant donné que les catégories doivent être traitées en premier par Kameleoon, tout produit sans catégorie connue sera ignoré lors du processus d’import.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 categories

ParamètreTypeRequisDescription
idStringOuiUn ID unique attribué à la catégorie
nameStringOuiNom de la catégorie
parentString/NULLOptionnelSi la catégorie est hiérarchique, ce champ définit un parent pour cette catégorie
urlStringOptionnelUne URL à associer à la catégorie
aliasStringOptionnelUn alias pour la catégorie

Exemple de requête JSON

{
    "shop_id": "eehj3eu84299kg5ghw5a6743r8",
    "shop_secret": "pmd5362597thrgq8k256ep01t0",
    "categories": [ {
            "id": "footwearID",
            "name": "footwear",
            "url": "https://example.com/footwear",
            "alias": "kicks"
        },
        {
            "id": "shoesID",
            "name": "shoes",
            "parent": "footwearID",
        },
        {
            "id": "bootsID",
            "name": "boots",
            "parent": "footwearID",
        }, ]
}