Yahoo!ショッピングAPI共通エラーコード一覧

Yahoo!ショッピングで提供している全てのAPIが共通で利用する、エラーコードの一覧を掲載します。 各API固有のエラーコードに関しては、それぞれのマニュアルページにある「エラー」をご確認ください。

また、Yahoo!デベロッパーネットワークで提供している全てのAPIに共通する、エラーの際に返すHTTPステータスコードも以下に掲載しておりますので、併せてご確認ください。

エラーコード一覧

エラーコード エラーメッセージ httpステータス 説明
px-04001 "seller_id" is not specified 400 ストアアカウント（seller_id）が空です。
ストアアカウントを指定してください。
px-04002 requested sellerId is illegal format. 400 ストアアカウント（seller_id）の形式が正しくありません。
指定しているストアアカウントを見直してください。
px-04003 Maximum upload size exceeded. 400 アップロードするファイルのサイズが25MB以上です。
ファイルサイズを見直してください。
px-04004 multipart/form bad request. 400 multipart/formのリクエスト形式が正しくありません。
リクエスト形式を見直してください。
px−04102 AccessToken has been expired. This API session is shorter than another API. 401 トークンの期限切れです。リフレッシュトークンを再取得してください。
トークンの有効期限を延長したい場合は、公開鍵を利用してください。
公開鍵の仕様はヘルプページ「公開鍵認証について」をご参照ください。
公開鍵を利用しているのにこのエラーが発生している場合は、正しく暗号化できていません。公開鍵認証の結果をレスポンスヘッダー(X-SWS-Authorize-Status)でご確認の上、仕様に沿って暗号化してください。
px-04104 Unverified Cookie. 401 テスト環境用のClient ID（アプリケーションID）で本番環境のAPIにリクエストしています。
本番用のClient ID（アプリケーションID）でリクエストしてください。

▼Client ID（アプリケーションID）の環境の確認方法
１．アプリケーションの管理より、対象のアプリケーションの「編集」ボタンを押す。
２．アプリケーションの詳細画面で「利用するスコープ」に表示されている文字列で、いずれかの環境を確認する。
環境名文字列
本番環境ストア向け操作関連の機能
テスト環境テスト環境　ストア向け操作関連の機能
px-04301 SellerID is invalid in this environment. 400 環境に適さないストアアカウント（seller_id）を利用しています。
各環境で配布されているストアアカウントを利用してください。
例：Sandbox環境用のストアアカウントで本番環境にアクセスした場合
px-04303 This application ID is not registered for using order API.
Use of order API requires an application ID.		 400 利用権限がないClient ID（アプリケーションID）でリクエストをしています。
注文・お問い合わせ管理・定期購入APIを利用するためには、別途利用申請が必要です。
下記ページからお申し込みください。
注文・お問い合わせ管理・定期購入API利用申請フォーム
px-04306 Access from this IP address is not allowed. 403 注文・お問い合わせ管理・定期購入APIに、許可されていないIPアドレスからリクエストをしています。
追加登録は、「Q. IPアドレスの追加・変更をしたい。」をご参照ください。
px-04400 Requested path is not exist. 404 指定したURLが存在しません。
正しいURLを指定してください。
px-14303 Use of API is not permitted. 403 ストアクリエイターProで従業員登録されていないビジネスIDでリクエストしています。
従業員登録されているビジネスIDでリクエストしてください。
px-14304 Use of API is not permitted. 403 許可されていないストアアカウント（seller_id）を利用しています。
sandbox環境では、Yahoo! JAPAN IDに紐づいたストアアカウント（snbx- で始まるストアアカウント）を利用してください。
px-14306 Use of API is not permitted. 403 退店している状態でリクエストしています。
退店したアカウントではAPIの利用が不可です。
px-05001 A system error occurred 500 ログインエラーです。
リフレッシュトークンを再取得してください。
px-05002 Internal Server Error 500 内部エラーです。
Yahoo!ショッピングで障害が発生している可能性がありますので「Yahoo!ショッピングのお知らせ」をご確認ください。
障害のお知らせがない場合は、しばらく時間をおいてからお試しください。
px-05007 Internal Server Error 500 ストアアカウント（seller_id）が誤っています。正しいストアアカウントを指定してください。
px-05010 Internal Server Error 500 内部エラーです。
しばらく時間をおいてからお試しください。

レスポンスサンプル（XML）

<?xml version='1.0' encoding='UTF-8' ?>
<Error>
　<Message>"seller_id" is not specified</Message>
　<Code>px-04001</Code>
</Error>

レスポンスサンプル（JSON）

{
  "Error" : {
    "Message" : "requested sellerId is illegal format.",
    "Code" : "px-04002"
  }
}

アプリケーションの管理

目次

利用のルール

開発のヒント