POST /v1/items/{id}/images

Scope

write_items

Request parameters

Name	In	Type	Required	Description
id	path	integer	required
Idempotency-Key	header	string	required	冪等キー（必須・ADR-010）
source_url	body	string	required	画像の取得元 URL（https のみ・jpeg/png・2MB まで。実バイトで MIME 判定）
type	body	enum(main	additional)	optional
orientation	body	enum(landscape	square)	optional

Response example

{
  "item_id": "string",
  "type": "main",
  "key": "string",
  "url": "string",
  "sort": 0,
  "orientation": "landscape"
}

Description

商品画像を登録・差し替える（URL 指定・メイン/追加）(write_items)

Error response example

{
  "error": {
    "code": "insufficient_scope",
    "message": "requires scope 'read_orders'",
    "request_id": "req_01H..."
  }
}

Possible errors: 400 / 401 / 403 / 404 / 422 / 503