Skip to main content
PUT
Import and update products
このエンドポイントは、商品を Kameleoon アカウントにインポートします。50,000 点以上の商品がある場合は、これがカタログをインポートする推奨方法です。 毎日カタログを完全に再インポートするのではなく、商品リストとそのプロパティの更新にもこのエンドポイントを使用することを強くお勧めします。
カタログのインポートに完全にこのエンドポイントを利用する場合は、カテゴリインポートエンドポイントを使用して、まずすべてのカテゴリがインポートされていることを確認してください。既知のカテゴリがない商品は、インポートプロセス中に無視されます。
データは、リクエスト本文に JSON 文字列として送信されます。

レート制限

  • API リクエスト制限(Rate Limit)は 1 分間に 40 リクエストで、最大で 1.5 秒に 1 リクエストです。
  • API リクエスト重量制限(Weight Limit)は 1 リクエストあたり最大 35 メガバイトに制限されています。

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

webhook の目的は、リクエストが完了したことを開発者に通知することです。API 呼び出しで指定されたすべての商品がインポートされ完全に利用可能になると、指定された Webhook に POST リクエストが送信されます。成功したリクエストの例:
失敗したリクエストの例:

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

特定の商品のみを更新したい場合は、リクエストで各商品のすべての必須パラメーター値を指定する必要があります。商品の必須プロパティのいずれかが省略された場合、インポート中にその商品は無視され、データベースには変更が加えられません。たとえば、商品の価格のみを更新したい場合でも、categories、name、picture、available などのすべての必須パラメーターを含める必要があります。必須でないプロパティについて、省略された値はデータベースからプロパティが削除される結果となります。

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

複数の場所がある場合に、場所に固有の価格、在庫、その他の情報を提供するために locations オブジェクトを使用します。商品アイテムオブジェクト内に locations オブジェクトを渡します。

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

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

params オブジェクトを使用すると、アイテムのカスタムパラメーター値を指定できます。商品 items オブジェクトの中に params オブジェクトを渡します。

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

fashion オブジェクトを使用すると、ファッションアイテムに関する追加情報を指定できます。商品 items オブジェクトの中に fashion オブジェクトを渡します。

JSON リクエスト例

ボディ

application/json
shop_id
string
必須

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
必須

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[]
必須

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.

レスポンス

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.

status
enum<string>

Request outcome.

利用可能なオプション:
success