メインコンテンツへスキップ
POST
/
endpoint
カテゴリのインポート
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
このエンドポイントは、すべての商品カテゴリを Kameleoon アカウントにインポートします。

HTTP リクエスト

POST https://api.products.kameleoon.com/import/categories
商品をアップロードする前に、最新のカテゴリリストを当社のデータベースにアップロードする必要があります。 データは、リクエスト本文を含む JSON 文字列として送信されます。すべてのカテゴリを 1 つのリクエストで送信する必要があります。

クエリパラメーターのリスト

パラメーター必須説明
shop_idStringYesストアキー。Kameleoon アプリの Recommendations > Settings > Store settings で確認できます。キーについては、カスタマーサクセスマネージャーにもお問い合わせいただけます。
shop_secretStringYesシークレットキー。Kameleoon アプリの Recommendations > Settings > Store settings で確認できます。キーについては、カスタマーサクセスマネージャーにもお問い合わせいただけます。
categoriesListYesカテゴリオブジェクトのリスト。categories に必要なパラメーターはこの表を参照してください。
webhookStringNoWebhook URL。インポート完了時に POST リクエストが送信されます。
webhook は、リクエストが完了したことを開発者に通知するために使用されます。API 呼び出しで指定されたすべてのカテゴリがインポートされ完全に利用可能になると、指定された Webhook に POST リクエストが送信されます。カテゴリを Kameleoon で処理するのに数分かかることがあるため、多数のカテゴリをインポートする場合は webhook の使用を強く推奨します。商品インポートエンドポイントを使用して商品をインポートしている場合、Webhook を使用することで、商品インポートを開始する前にすべてのカテゴリが完全に処理されたことを保証できます。カテゴリは最初に Kameleoon で処理する必要があるため、既知のカテゴリがない商品はインポート中に無視されます。成功したリクエストの例:
{
	"status": "success"
}
失敗したリクエストの例:
{
	"status": "error", 
	"message": "MESSAGE"
}

categories オブジェクトのパラメーターリスト

パラメーター必須説明
idStringYesカテゴリに割り当てられた一意の ID
nameStringYesカテゴリの名前
parentString/NULLOptionalカテゴリが階層構造の場合、このフィールドにはこのカテゴリの親を定義します
urlStringOptionalカテゴリに関連付ける URL
aliasStringOptionalカテゴリのエイリアス

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",
        }, ]
}