GET /1/items

商品情報の一覧を取得

scope

read_items

リクエストパラメーター

Name	Description
visible	公開ステータス 1:表示、0:非表示 (任意)
order	並び替え項目。list_order、created、modifiedのいずれか (任意 デフォルト: list_order)
sort	並び順。asc か desc のいずれか (任意 デフォルト: asc)
limit	リミット (任意 デフォルト: 20, MAX: 100)
offset	オフセット (任意 デフォルト: 0)
max_image_no	画像番号 1~20 (任意 デフォルト: 5)
image_size	画像サイズ。origin、76、146、300、500、640、sp_480、sp_640からカンマ区切りで複数指定 (任意 デフォルト: origin)
category_id	カテゴリID (任意 デフォルト: 指定なし)

レスポンスの例

{
  "items":[
    {
      "item_id":1234,
      "title":"Tシャツ",
      "detail":"とってもオシャレなTシャツです。",
      "price":3900,
      "proper_price":null,
      "item_tax_type":1,
      "stock":10,
      "visible":1,
      "list_order":1,
      "identifier":"abcd-1234",
      "img1_origin":"https://base-ec2.akamaized.net/images/item/origin/45fc036c772c8469fa40396b2ef0fb9b.jpg",
      "img2_origin":"https://base-ec2.akamaized.net/images/item/origin/2a4de4965fa23b7b89944199713a827e.jpg",
      "img3_origin":null,
      "img4_origin":null,
      "img5_origin":null,
      "modified":1414731171,
      "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"
        }
      ]
    },
    {
      "item_id":12345,
      "title":"ロングTシャツ",
      "price":4900,
      "proper_price":null,
      "item_tax_type":1,
      "stock":20,
      "visible":1,
      "list_order":2,
      "identifier":null,
      "img1_origin":"https://base-ec2.akamaized.net/images/item/origin/45fc036c772c8469fa40396b2ef0fb9b.jpg",
      "img2_origin":"https://base-ec2.akamaized.net/images/item/origin/2a4de4965fa23b7b89944199713a827e.jpg",
      "img3_origin":null,
      "img4_origin":null,
      "img5_origin":null,
      "modified":1414731172,
      "variations":[
        {
          "variation_id":21,
          "variation":"Mサイズ",
          "variation_stock":12,
          "variation_identifier":null,
          "barcode":null
        },
        {
          "variation_id":22,
          "variation":"Lサイズ",
          "variation_stock":8,
          "variation_identifier":null,
          "barcode":null
        }
      ]
    }
  ]
}

解説

• item_id - 商品を識別するユニークなID
• price - 商品の価格 (税込み)
• 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

エラーレスポンスの例

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

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

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