items

GET /1/items

商品情報の一覧を取得

scope

read_items

リクエストパラメーター

NameDescription
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":"スコープが無効です。"
}
← users/meitems/search →