複数店頭在庫情報取得API

複数商品の店頭在庫情報を取得することができます。

変更履歴

2020年10月06日

仕様書を公開しました。

リクエストURL

本番環境
https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/getRealStockList
テスト環境
https://test.circus.shopping.yahooapis.jp/ShoppingWebService/V1/getRealStockList

テスト用APIを利用したい場合は、こちらから利用申請をお願いします。

リクエストパラメータ

Web APIの使い方#GETとは」をご参照ください。

リクエストURL

パラメータ 必須 デフォルト値 値の例 説明 補足
/sellerId teststore セラーID
/items 店舗在庫情報の配列
/stores/srId item0001 セラーリソース識別子
/stores/skuId blue_s 商品在庫単品管理ID skuが無い商品はNULL可

サンプルリクエストURL

curl -X POST "https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/getRealStockList" -H  "accept: application/json" -H  "Content-Type: application/json" -d
'{
  "sellerId": "teststore",
  "stocks": [
    {
      "srId": "item0001",
      "skuId": "blue_s"
    },
    {
      "srId": "item0002",
      "skuId": "red_l"
    }
  ]
}'

レスポンスフィールド

要素 値の例 説明
/stocks Array 在庫オブジェクト配列
/stocks/sellerId string teststore セラーID
/stocks/srId string item0001 セラーリソース識別子
/stocks/skuId string blue_s 商品在庫単品管理ID
/stocks/storeInStock string 1:3:10 店頭在庫ありの店舗コードリスト
/stocks/storeInStockFew string 1:3:10 店頭在庫わずかの店舗コードリスト
/stocks/storeInStockUpdatedTime string 2020-01-31 23:05:00 店頭在庫更新日時

サンプルレスポンス

レスポンス(JSON)

{
  "stocks": [
    {
      "sellerId": "teststore",
      "srId": "item0001",
      "skuId": "blue_s",
      "storeInStock": "1:3:10",
      "storeInStockFew": "1:3:10",
      "storeInStockUpdatedTime": "2020-01-31 23:05:00"
    },
    {
      "sellerId": "teststore",
      "srId": "item0002",
      "skuId": "red_l",
      "storeInStock": "1:3:10",
      "storeInStockFew": "1:3:10",
      "storeInStockUpdatedTime": "2020-01-31 23:05:00"
    }
  ]
}

エラー

Yahoo!ショッピングで提供している全てのAPIには、共通で利用するエラーコードがあります。エラーの際には、まず始めに以下をご確認ください。

複数店頭在庫情報取得APIで固有に返すエラーは、以下のJSONレスポンスを返します。

要素
/type string
/title int
/status string
/detail string

サンプルエラーレスポンス

{
  "type":"about:blank",
  "title":"Bad Request",
  "detail":"Failed to read HTTP message",
  "status":400
}

ご注意

※こちらのAPIはYahoo! ID連携に対応したAPIです。
Yahoo! ID連携によるAPIアクセス方法の詳細は、以下のページをご確認ください。

※こちらのAPIを利用する場合は、こちらからClient ID(アプリケーションID)を取得してください。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。(1クエリー/秒)

利用約款

このAPIに関する利用約款はこちら

アプリケーションの管理

利用のルール

開発のヒント