店舗在庫情報削除API
店舗在庫情報を削除することができます。
変更履歴
2020年10月06日
仕様書を公開しました。
リクエストURL
本番環境
https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/deleteRealStock
テスト環境
https://test.circus.shopping.yahooapis.jp/ShoppingWebService/V1/deleteRealStock
テスト用APIを利用したい場合は、こちらから利用申請をお願いします。
リクエストパラメータ
「Web APIの使い方#DELETEとは」をご参照ください。
リクエストURL
パラメータ | 必須 | デフォルト値 | 値の例 | 説明 | 補足 |
---|---|---|---|---|---|
/sellerId | 〇 | teststore | セラーID | ||
/stocks | 〇 | 店舗在庫情報の配列 | |||
/stocks/srId | 〇 | item0001 | セラーリソース識別子 | ||
/stocks/skuId | blue_s | 商品在庫単品管理ID | skuの無い商品はNULL可 |
サンプルリクエストURL
curl -X DELETE "https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/deleteRealStock" -H "Content-Type: application/json" -d '{
"sellerId": "teststore",
"stocks": [
{
"srId": "item0001",
"skuId": "blue_s"
},
{
"srId": "item0002",
"skuId": "red_l"
}
]
}'
レスポンスフィールド
要素 | 型 | 値の例 | 説明 |
---|---|---|---|
/status | string | ok | ステータス |
サンプルレスポンス
レスポンス(JSON)
{
"status": "ok"
}
エラー
Yahoo!ショッピングで提供している全てのAPIには、共通で利用するエラーコードがあります。エラーの際には、まず始めに以下をご確認ください。
店舗在庫情報削除APIで固有に返すエラーは、以下のJSONレスポンスを返します。
要素 | 型 |
---|---|
/type | string |
/title | string |
/detail | string |
/status | integer |
サンプルエラーレスポンス
{
"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に関する利用約款はこちら。