【2026/03/26更新】商品画像の登録エンドポイントを公開しました

2026/03/16

任意の商品 ID を指定して、商品画像をアップロードできるエンドポイントを公開しました。

提供開始日時

2026年3月16日(月) 15:00

リクエストボディ

multipart/form-data 形式で以下のパラメータを送信します。

キー名	説明	型
image	画像ファイル（JPEG, PNG, GIF、最大 5MB）	バイナリ
position	画像の表示位置（0〜49）	整数

レスポンス

{
  "product": {
    "id": 175597806,
    "images": [
      {
        "position": 0,
        "url": "https://img07.shop-pro.jp/XXX/XX/product/123.jpg?cmsp_timestamp=20260311000000"
      }
    ]
  }
}

詳細

キー名	説明	型
id	商品 ID	整数
images	登録された商品画像の配列	配列
position	表示順（0〜49）	整数
url	画像 URL	文字列

備考

対応画像形式: JPEG, PNG, GIF (最大 5MB)
position の値によって画像の用途が異なります
- 0はメイン画像になり、サムネイルが作成されます
- 1〜49は、その他画像のそれぞれの表示順に対応します
同じ position に画像が既に存在する場合は上書きされます
レート制限: 10秒間に 5 リクエストまで
必要スコープ: read_products, write_products
(2026/03/26 追記) 利用者が多い場合はレートリミットに限らず一時的にリクエストを制限する可能性があります。その場合は 503 ステータスコードが返されますので、しばらく待ってからリトライしてください

詳細は以下のドキュメントを確認ください。

商品画像の登録