Yahoo!ショッピングAPIのよくあるご質問

目次

よくある質問TOP3

「Please provide valid credentials...」が返ってくる。

ご利用中の"アプリケーションID"にショッピングAPIの利用権限が付いていない可能性があります。

下記レスポンスが対象です。 

Please provide valid credentials. Bearer realm="yahooapis.jp",
    error="insufficient_scope", error_description="insufficient scope"

  1. 「アプリケーションの管理」ページで"アプリケーションID"に付いた権限を確認します。
  2. 「アプリケーション一覧」からご利用中のアプリケーションを選択する。
  3. ページ下部の「利用するスコープ」を確認する。
  4. 「ストア向け操作関連の機能 (開示先限定スコープ)」が付いていない場合
    →「ショッピング用アプリケーションID取得ページ」からIDを取得する。
    「ストア向け操作関連の機能 (開示先限定スコープ)」が付いている場合
    →そのままご利用いただいて問題ございません。
API証明書をダウンロードしました。その後はどのようにすればいいでしょうか？

※コマースパートナ提供のツールをご利用中の場合は、ツール提供元の指示に従って設定をしてください。

下記ページの「証明書の利用方法」をご確認ください。
https://developer.yahoo.co.jp/webapi/shopping/help.html#orderapicertificate

こちらのサンプルに記載されているように、ダウンロードしていただいた２つのファイルを
注文・お問い合わせ管理APIにリクエストする際のオプションにセットしてご利用してください。

「px-04303 ： This application ID is not registered for using order API. Use of order API requires an application ID.」が返ってくる。

注文・お問い合わせ管理APIを利用するためには、別途利用申請が必要です。
利用権限がないアプリケーションIDでリクエストをしているためエラーを返しています。

下記ページからお申し込みください。
注文・お問い合わせ管理API利用申請フォーム

新決済方法「PayPay」について

テスト環境はありますか？
テスト環境（sandbox）にて提供中です。
申請についてはヘルプページの「テスト環境を利用したい。」をご確認ください。
導入により影響があるAPIは？

下記APIに影響があります。

※詳細は上記ページをご確認ください。

クレジットカードを併用された場合のレスポンスは？

※テスト環境を利用して実際のレスポンスをご確認ください。

注文詳細API
【「PayPay」+「クレジットカード決済」併用の場合】をご確認ください。

▼ 説明

  • PayMethod（支払い方法）
    メインの支払い方法である「PayPay残高払い（payment_a17）」がセットされます。
  • CombinedPayMethod（併用お支払い方法）
    併用する支払い方法の「クレジットカード決済（payment_a1）」がセットされます。
  • TotalPrice（合計金額）
    支払う金額の合計がセットされます。
  • PayMethodAmount（支払い金額）
    「PayPay残高払い」で支払う金額がセットされます
  • CombinedPayMethodAmount（併用支払い金額）
    「クレジットカード決済」で支払う金額がセットされます。

Yahoo!ID連携（v1）について

リフレッシュトークンが突然無効になりました
リフレッシュトークンは有効期限前でもパスワード変更やユーザの同意撤回により無効になることがあります。
更新時にinvalid_grantが返却されたらAuthorizationリクエストからやり直してください。
ログインしようとすると"redirect_uri is invalid."と表示されます
アプリケーションIDに設定されている「コールバックURL」とリクエスト時のredirect_uriパラメータの値が一致している必要があります。
「コールバックURL」はアプリケーションIDを発行したYahoo! Japan IDでログインした状態で下記ページをご確認ください。
https://e.developer.yahoo.co.jp/dashboard/
リフレッシュトークンを期限切れ前に再取得すると古いリフレッシュトークンは無効になりますか?
（取得し直したら文字列が変わっていなかった）
有効期限が切れる前にトークンを取得しなおした場合、リフレッシュトークンの文字列は変わらず有効期限のみが更新されます。
有効期限が切れた後にトークンを取得すると新しい文字列のリフレッシュトークンになります。
アクセストークンを期限切れ前に更新すると古いアクセストークンは無効になりますか?
即時に無効にはなりません。新旧どちらも有効です。
「シークレット」はどこで確認できますか？
Yahoo! JAPAN IDでログインした状態でこちらページをご確認ください。
PHP以外のサンプルはありませんか？
Java Servletライブラリを公開しています。
https://developer.yahoo.co.jp/yconnect/v1/server_app/java/sample.html

「注文API」「問い合わせ管理API」の利用申請について

「アプリケーションID」はどこで確認ができますか？
Yahoo! JAPAN IDでログインした状態でこちらページをご確認ください。
IPアドレスの追加・変更をしたい。
ショッピングAPI利用申請フォームから再申請をお願い致します。
（IPの部分は追加分の情報のみで問題ございません。）
設定完了の連絡が来ない。
設定完了まで約1週間〜10日程度お時間をいただく場合がございます。
設定完了後、申請時に入力したメールアドレス宛に通知がされます。
申請時に入力した"IPアドレス"を確認できますか?
恐れ入りますが、利用者様のほうで確認をできるページ等は用意しておりません。
お手数をおかけしますが「お問い合わせ専用フォーム」からお問い合わせください。

「証明書」について

証明書はどこからダウンロードできますか？
ストアクリエイタProトップのページ上部に「ダウンロード」ボタンが表示されます。
「ダウンロード」ボタンが表示されません。
管理者権限を持った方のみダウンロードが可能です
ダウンロードした後はどうすればいいですか？
ヘルプの「証明書の利用方法」をご確認ください。
有効期限切れ前にメールが来た。更新をするにはどうしたらいいですか?
自動更新されますので、別途申請は不要です。
利用中の証明書の有効期限はいつまでですか？
有効期限は発行から1年間です。
有効期限を確認するページ等は用意しておりません。
期限切れ1,2か月前の2回メールで告知を行っております。
ダウンロードしたファイルが開くことができません。
開いて確認していただく必要はありません。
（開いて内容が確認できるものではありません。）
ヘルプページのサンプルを確認しましたが、更新方法がわかりません。
現在利用中の古い証明書ファイルとダウンロードした新しいファイルを交換してください。
※コマースパートナ提供のツールをご利用中の場合は、ツール提供元の指示に従って設定をしてください。

エラー全般について

「Your Request was Forbidden」が返ってくる。
原因として以下3点が考えられます。
  • リクエスト数が上限（50000回）を超えている。
    対処方法：1日50,000リクエストを超える場合は、アプリケーションIDを追加してご対応ください。
  • 存在しないアプリケーションIDでリクエストしている。
    対処方法：実際にリクエストを行っているアプリケーションIDをご確認ください。
  • 接続が許可されていないアプリケーションIDでアクセスしている。
    対処方法：恐れ入りますが、お問い合わせフォームからご連絡をお願いします。
「invalid_token」が返ってくる。
以下のようなレスポンスが返ってくる場合は、アクセストークンの有効期限が切れております。
リフレッシュトークンを利用してアクセストークンの更新をお願いします。 
<?xml version="1.0" encoding="utf-8" ?>
<Error>
<Message>
Please provide valid credentials. Bearer realm="yahooapis.jp", error="invalid_token", error_description="expired token"
</Message>
</Error>
アクセストークン取得後にリクエストすると「px-14301」が返ってくる。
ログインした際の「Yahoo! JAPAN ID」をご確認ください。
リクエストする「ストアアカウント」と「Yahoo! JAPAN ID」に紐づく「ビジネスID」が同一のものをご利用ください。
「od91008」が返ってくる。
※注文ステータス変更API(orderStatusChange)にリクエストしている場合
出荷ステータス更新API(orderShipStatusChange)を実行した直後に
注文ステータス変更API(orderStatusChange)にリクエストすると、こちらのエラーが発生する可能性があります。
出荷ステータス更新APIを実行した場合は、実行後しばらく時間をおいてから注文ステータス変更APIを実行してください。

テスト環境（sandbox）について

ストアアカウントを確認したい。
ストアアカウントは設定完了メールに記載しております。
件名：【重要】テスト環境利用申請者の方へご案内：Yahoo!ショッピング
利用申請をしたが、メールが届かない。
過去に利用申請をしている場合、メール配信を行っておりません。
発行済みのテスト環境の詳細については、新規発行時に配信しているメールをご確認ください。
件名：【重要】テスト環境利用申請者の方へご案内：Yahoo!ショッピング
※１つのYahoo!JAPAN IDにつき、利用できるテスト環境は１つのみです。
エラーが出てテスト注文ができません。
「反映」実施してください。
未反映項目がない場合は、反映項目を発生させてから反映をお願いします。
FTPサーバは利用できますか？
テスト環境についてはFTPサーバを用意しておりません。
テスト用のクレジットカードはありますか？
ご用意しております。
Yahoo!デベロッパーネットワーク（ショッピング）
ページ上部にある「Yahoo!ショッピングAPIマニュアル（pdf）」のP.66をご確認ください。
「ポイント」を利用した注文はできますか？
テスト環境では「ポイント」の付与・利用ができないようになっております。
その他、本番環境との仕様の違いはこちらのページに記載しております。
「クーポン」を利用した注文はできますか？
テスト環境では「クーポン」の発行・利用ができないようになっております。
その他、本番環境との仕様の違いはこちらのページに記載しております。

その他

サンプルコードはありませんか？

PHP版のサンプルコードをご用意しております。
※恐れ入りますが、その他言語のサンプルの用意はございません。

サーバを移管しました。
必要な対応はありますか？
注文・問い合わせ管理APIを利用していて、リクエスト元IPアドレスに変更がある場合のみ申請をお願いします。
下記ページからお申し込みください。（新しいIPをご入力ください。）
注文・お問い合わせ管理API利用申請フォーム
利用回数に制限はありますか？
短時間に大量のリクエストが行われた場合には、利用を制限させていただくことがあります。

アプリケーションの管理

開発のヒント