商品個別反映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に関する利用約款はこちら

アプリケーションの管理

目次

利用のルール

開発のヒント