items/add_image

POST /1/items/add_image

商品情報の画像を登録

scope

write_items

リクエストパラメーター

NameDescription
item_id商品ID (必須)
image_no画像番号 1~20 (必須)
image_url画像URL。jpgかpngかgif。容量4M以内。推奨サイズは640×640px。 (必須)

※ originサイズ以外はcronのバッチ処理で作られます。

レスポンスの例

{
  "item":{
    "item_id":1234,
    "title":"Tシャツ",
    "detail":"とってもオシャレなTシャツです。",
    "price":3900,
    "proper_price":null,
    "stock":10,
    "visible":1,
    "list_order":1,
    "identifier":"abcd-1234",
    "modified":1414731174,

    "img1_origin":"https://base-ec2.akamaized.net/images/item/origin/45fc036c772c8469fa40396b2ef0fb9b.jpg",
    "img1_76":null,
    "img1_146":null,
    "img1_300":null,
    "img1_500":null,
    "img1_640":null,
    "img1_sp_480":null,
    "img1_sp_640":null,

    "img2_origin":null,
    "img2_76":null,
    "img2_146":null,
    "img2_300":null,
    "img2_500":null,
    "img2_640":null,
    "img2_sp_480":null,
    "img2_sp_640":null,

    "img3_origin":null,
    "img3_76":null,
    "img3_146":null,
    "img3_300":null,
    "img3_500":null,
    "img3_640":null,
    "img3_sp_480":null,
    "img3_sp_640":null,

    "img4_origin":null,
    "img4_76":null,
    "img4_146":null,
    "img4_300":null,
    "img4_500":null,
    "img4_640":null,
    "img4_sp_480":null,
    "img4_sp_640":null,

    "img5_origin":null,
    "img5_76":null,
    "img5_146":null,
    "img5_300":null,
    "img5_500":null,
    "img5_640":null,
    "img5_sp_480":null,
    "img5_sp_640":null,

    "variations":[
      {
        "variation_id":11,
        "variation":"黒",
        "variation_stock":6,
        "variation_identifier":"abcd-1234-b",
        "barcode":"abcd-1234-b"
      },
      {
        "variation_id":12,
        "variation":"白",
        "variation_stock":4,
        "variation_identifier":"abcd-1234-w",
        "barcode":"abcd-1234-w"
      }
    ],

    "options":[
      {
        "option_id":3,
        "option_name":"選択式オプション",
        "option_type":"select",
        "required":true,
        "list_order":3,
        "select":{
          "option_variations":[
            {
              "option_variation_id":5,
              "variation_name":"選択式項目その1",
              "price":100,
              "list_order":1
            },
            {
              "option_variation_id":6,
              "variation_name":"選択式項目その2",
              "price":200,
              "list_order":2
            }
          ]
        },
        "form":null
      },
      {
        "option_id":4,
        "option_name":"文字入れ式オプション",
        "option_type":"form",
        "required":false,
        "select":null,
        "list_order":4,
        "form":{
          "option_variation_id":7,
          "price":300,
          "free_text_description":"補足説明",
          "free_text_max_length":30,
          "list_order":1
        }
      }
    ]
  }
}

解説

  • item_id - 商品を識別するユニークなID
  • price - 商品の価格 (税込み)
  • title - 商品名
  • detail - 商品説明
  • proper_price - 商品の通常価格 (税込み)
  • item_tax_type - 商品の税率設定。1:標準税率、2:軽減税率
  • stock - 在庫数
  • visible - 表示フラグ。1:表示、0:非表示
  • list_order - 表示順
  • identifier - 商品コード
  • img1_origin - 商品画像1のオリジナルサイズ
  • variations - バリエーション情報
    • variation_id - バリエーションを識別するユニークなID
    • variation - バリエーションの種類
    • variation_stock - バリエーションの在庫数
    • variation_identifier - バリエーションの種類コード
    • barcode - バリエーションのJAN/GTIN
  • options - 商品オプション情報
    • option_id - 商品オプションを識別するユニークなID
    • option_name - 商品オプション名
    • option_type - 商品オプションのタイプ select:選択式, form:文字入れ式
    • required - 商品オプションが必須フラグ true:必須、false:任意
    • list_order - 商品オプション表示順
    • select - 選択式情報 (option_type = form の時は値が null )
      • option_variations
        • option_variation_id - 商品オプション項目を識別するユニークなID
        • variation_name - 商品オプション項目名
        • price - 商品オプション価格
        • list_order - 商品オプション項目表示順
    • form - 文字入れ式情報 (option_type = select の時は値が null )
      • option_variation_id - 商品オプション項目を識別するユニークなID
      • price - 商品オプション価格
      • free_text_description - 文字入れ式の補足説明
      • free_text_max_length - 文字入れ式の文字数制限
      • list_order - 商品オプション項目表示順

エラーレスポンスの例

{
  "error":"access_denied",
  "error_description":"httpsでアクセスしてください。"
}

{
  "error":"invalid_request",
  "error_description":"アクセストークンが無効です。"
}

{
  "error":"invalid_scope",
  "error_description":"スコープが無効です。"
}

{
  "error":"not_post_method",
  "error_description":"POSTで送信してください。"
}

{
  "error":"bad_params",
  "error_description":"不正なパラメーターです。"
}

{
  "error":"bad_item_id",
  "error_description":"不正なitem_idです。"
}

{
  "error":"no_image",
  "error_description":"画像を取得できませんでした。"
}

{
  "error":"image_put_fail",
  "error_description":"画像の書き出しに失敗しました。"
}

{
  "error":"validation_error",
  "error_description":"バリデーションエラーです。"
}

{
  "error":"invalid_request",
  "error_description":"デジタルコンテンツの商品は編集できません。"
}

{
  "error":"invalid_request",
  "error_description":"ClubTの商品は編集できません。"
}

{
  "error":"invalid_request",
  "error_description":"SpCaseの商品は編集できません。"
}

{
  "error":"invalid_request",
  "error_description":"定期便商品は編集できません。"
}

{
  "error":"invalid_request",
  "error_description":"予約商品は編集できません。"
}

{
  "error":"invalid_request",
  "error_description":"抽選商品は編集できません。"
}

{
  "error":"invalid_request",
  "error_description":"テイクアウト商品は編集できません。"
}

{
  "error":"invalid_request",
  "error_description":"コミュニティ限定商品は編集できません。"
}
← items/deleteitems/delete_image →