商品個別反映API
指定した商品データを1つだけを反映します。
変更履歴
2024年5月23日
正常レスポンス時の反映エラーについて追記しました。
リクエストURL
XML
https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/submitItem
XML
https://test.circus.shopping.yahooapis.jp/ShoppingWebService/V1/submitItem
テスト用APIを利用したい場合は、こちらから利用申請をお願いします。
リクエストパラメータ
「Web APIの使い方#POSTとは」をご参照ください。
パラメータ | 値 | 説明 |
---|---|---|
seller_id (必須) |
string | ストアアカウントを指定します。 |
item_code (必須) |
string | 商品コードを指定します。 |
サンプルリクエストURL
https://circus.shopping.yahooapis.jp/ShoppingWebService/V1/submitItem
サンプルリクエスト
POST /ShoppingWebService/V1/submitItem HTTP/1.1
Host: circus.shopping.yahooapis.jp
Authorization: Bearer <アクセストークン>
seller_id=teststore&item_code=item1
レスポンスフィールド
フィールド | 説明 |
---|---|
/ResultSet | クエリーレスポンスのすべてを含みます。 |
/ResultSet/Result | 各個別レスポンスを含みます。 |
/ResultSet/Result/Status | 更新結果(このフォーマットではOKのみです。) ※OKレスポンスが返却されてもシステムの処理途中でエラーになる場合があるため、反映履歴または反映エラーメールをご確認ください |
サンプルレスポンス
<?xml version="1.0" encoding="UTF-8" ?>
<ResultSet>
<Result>
<Status>OK</Status>
</Result>
</ResultSet>
エラー
Yahoo!ショッピングで提供している全てのAPIには、共通で利用するエラーコードがあります。エラーの際には、まず始めに以下をご確認ください。
商品系API、および商品個別反映APIで固有に返すエラーコードは以下をご覧ください。
商品系API共通エラーコード
コード | HTTPステータスコード | 説明 |
---|---|---|
ed-00000 | 404 | ページが見つかりません。 |
ed-00001 | 500 | システムエラーが発生しました。 |
ed-00002 | 503 | サーバがメンテナンス中です。 |
ed-00003 | 400 | ストアアカウントが指定されていません。 |
ed-00004 | 400 | ストアアカウントが存在しません。 |
ed-00005 | 400 | ストアアカウントの指定が不正です。 |
ed-00006 | 400 | 反映またはアップロード中のため更新ができません。 |
エラーコード
コード | HTTPステータスコード | 説明 |
---|---|---|
it-07001 | 400 | item_codeが指定されていません。 |
it-07002 | 400 | 指定された商品コードは存在しません。 |
it-07003 | 400 | テンプレートを変更したページは個別反映できません。 |
it-07004 | 400 | 新規ページは個別反映できません。 |
it-07005 | 400 | 親カテゴリとページ公開設定が一致しないことになるため、個別反映できません。 |
it-07006 | 400 | 親カテゴリと隠しページ設定が一致しないことになるため、個別反映できません。 |
it-07007 | 400 | ページ公開設定を変更したカテゴリページは個別反映できません。 |
it-07008 | 400 | 隠しページ設定を変更したカテゴリページは個別反映できません。 |
it-07009 | 400 | 契約商品上限数を超えるため、反映できません。 |
it-07010 | 400 | カスタムページ上限数を超えるため、反映できません。 |
利用制限
※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。(1クエリー/秒)
利用約款
このAPIに関する利用約款はこちら。
目次
- 商品検索
- カテゴリランキング
- カテゴリID取得
- 商品コード検索(商品詳細)
- キーワードランキング
- おすすめ情報モジュール
- ポイントキャンペーン情報取得
- 販促イベント検索
- 商品レビュー検索
- 出品管理に関連するAPI
- 商品に関連するAPI
- 問い合わせ管理に関連するAPI
- 製品/SHPカテゴリ/ブランドに関連するAPI
- 在庫に関連するAPI
- ストアカテゴリに関連するAPI
- 画像に関連するAPI
- デザインに関連するAPI
- 注文に関するAPI
- ヘルプ