開発者向けサポート

/items/{id}

必要権限

  • item

提供メソッド

GET

サンプル
リクエスト
GET /items/1.json?select=ITEM_CD,ITEM_NAME,TEIKA,categories(CATEGORY_NAME)
レスポンス
200 OK

{"ITEM_CD": "item01", "ITEM_NAME": "商品1", "TEIKA": 4000, "categories": [{"CATEGORY_NAME": "カテゴリ1"}]}
リクエスト文説明
クエリーパラメータ

select
取得する列名を指定します。指定しない場合は ITEM_ID,ITEM_CD,ITEM_NAME,TEIKA,MAKER_TEIKA,ITEM_IMAGE1,ITEM_IMAGE2,ITEM_IMAGE3,ITEM_IMAGE4,M_ITEM_IMAGE1,M_ITEM_IMAGE2,M_ITEM_IMAGE3,M_ITEM_IMAGE4,ITEM_APPEAL_IMAGE,ITEM_APPEAL,M_ITEM_APPEAL_IMAGE,M_ITEM_APPEAL,ITEM_INFO1,M_ITEM_INFO1,SALE_DATE,ZAIKO_FLG,ZAIKO_DISP_FLG,MIN_ZAIKO,MIN_QUANTITY,DISCOUNT_FLG,MEMBER_WARIBIKI,NEW_UPDATE_DATE,SORYO_FREE_FLG を指定した場合と同じ動作をします。
item_property_name_list_delimiter
バリエーション名リスト(ITEMPROPERTY_NAME_LIST)で使用する区切り文字を指定します。

応答値説明
ボディー文字列

商品情報を格納したJSON値を返します。

PUT

サンプル
リクエスト
PUT items/1.json

{"FREE_ITEM1":1}
レスポンス
200 OK
リクエスト文説明
ボディー文字列

商品の情報を格納したJSON文字列、形式はGETと同一です。
カテゴリ、SKUを指定した場合、トランザクションを使用するとエラーになります。
カテゴリはカテゴリID、カテゴリコードが指定可能です。他の値が指定された場合、エラーとなります。カテゴリID、カテゴリコードの両方が指定されていた場合、カテゴリIDを優先して使用します。
カテゴリを指定した場合、指定された商品とカテゴリの関連付けで登録しなおします(未指定のカテゴリで現在登録されているものは削除されます)。すべての商品とカテゴリの関連付けを削除したい場合、categoriesに空の配列を指定してください。
SKUを指定した場合、指定されたSKUで登録しなおします(未指定のSKUで現在登録されているものは削除されます)。すべてのSKUを削除したい場合、skusに空の配列を指定してください。
在庫が1以上あるSKUを削除することはできません。削除対象になるとエラーになります。また、セットの子商品である場合、商品バリエーションの組み合わせパターンを変更することはできません。
calculate_columnsにカラム名を指定した場合、登録済みの値と指定した値を元に加算もしくは減算を行うSQL文を構築し実行します。

応答値説明

DELETE

サンプル
リクエスト
DELETE /items/1.json
レスポンス
200 OK
リクエスト文説明
応答値説明