ショッピング
Yahoo!ショッピングAPIのよくあるご質問
目次
よくある質問TOP3
API証明書をダウンロードしました。その後はどのようにすればいいでしょうか？
※コマースパートナ提供のツールをご利用中の場合は、ツール提供元の指示に従って設定をしてください。下記ページの「証明書によるリクエスト方法事例」をご確認ください。
https://developer.yahoo.co.jp/webapi/shopping/help.html#orderapicertificate
こちらのサンプルに記載されているように、ダウンロードしていただいた２つのファイルを
注文・お問い合わせ管理APIにリクエストする際のオプションにセットしてご利用してください。
テスト環境の申請をしたが、設定完了の連絡が来ない。
※設定完了までには1週間～10日間お時間をいただいております。設定完了後、申請時のYahoo! JAPAN IDに紐づく「メインメールアドレス」宛に設定完了メールを送信しています。
こちらのページから「メインメールアドレス」のご確認をお願いします。
「px-04303 ： This application ID is not registered for using order API. Use of order API requires an application ID.」が返ってくる。
注文・お問い合わせ管理APIを利用するためには、別途利用申請が必要です。 利用権限がないアプリケーションIDでリクエストをしているためエラーを返しています。下記ページからお申し込みください。
注文・お問い合わせ管理API利用申請フォーム
新決済方法「PayPay」について
| ご質問 | 回答 |
|---|---|
| テスト環境はありますか？ |
「2019年05月27日（月）」から提供を開始させていただく予定です。 【Yahoo!ショッピング】新決済サービス「PayPay」テスト環境についてのお知らせ（訂正版） |
| 導入により影響があるAPIは？ |
下記APIに影響があります。 ・注文詳細API ・注文検索API ・注文内容変更API ・注文操作履歴一覧API ※詳細は上記ページをご確認ください。 |
| PayPayとクレジットカードを併用された場合、どのようなレスポンスが返されますか？ |
下記ページの【「PayPay」+「クレジットカード決済」併用の場合】参照 注文詳細API ※PayPay残高払い：300円、クレジットカード決済：200円 = 計500円のパターン ▼ 説明 ・PayMethod（支払い方法） メインの支払い方法である「PayPay残高払い（payment_a17）」がセットされます。 ・CombinedPayMethod（併用お支払い方法） 併用する支払い方法の「クレジットカード決済（payment_a1）」がセットされます。 ・TotalPrice（合計金額） 支払う金額の合計がセットされます。 ・PayMethodAmount（支払い金額） 「PayPay残高払い」で支払う金額がセットされます。 ・CombinedPayMethodAmount（併用支払い金額） 「クレジットカード決済」で支払う金額がセットされます。 |
Yahoo!ID連携（v1）について
| ご質問 | 回答 |
|---|---|
| リフレッシュトークンが突然無効になりました | リフレッシュトークンは有効期限前でもPW変更やユーザの同意撤回により無効になることがあります。更新時にinvalid_grantが返却されたらAuthorizationリクエストからやり直してください。 |
| ログインしようとすると"redirect_uri is invalid."と表示されます | アプリケーションIDに設定されている「コールバックURL」または「カスタムURIスキーム」とリクエスト時のredirect_uriパラメータの値が一致している必要があります。 コールバックURL／カスタムURIスキームは下記URLから変更可能です。 アプリケーションIDを発行したYIDでログインし、設定をご確認ください。 https://e.developer.yahoo.co.jp/dashboard/ |
| リフレッシュトークンを期限切れ前に再取得すると古いリフレッシュトークンは無効になりますか? （取得し直したら文字列が変わっていなかった） |
有効期限が切れる前にトークンを取得しなおした場合、リフレッシュトークンの文字列は変わらず有効期限のみが更新されます。有効期限が切れた後にトークンを取得すると新しい文字列のリフレッシュトークンになります。 |
| アクセストークンを期限切れ前に更新すると古いアクセストークンは無効になりますか? | 即時に無効にはなりません。新旧どちらも有効です。 | 「シークレット」はどこで確認ができますか？ | 下記ぺージからご確認ください https://e.developer.yahoo.co.jp/dashboard/ アプリケーション一覧から任意のものを選択していただき「アプリケーション情報」タブからご確認ください。 |
| PHP以外のサンプルはありませんか？ | Java Servletライブラリを公開しています。下記ぺージをご確認ください。 https://developer.yahoo.co.jp/yconnect/v1/server_app/java/sample.html |
「注文API」「問い合わせ管理API」の利用申請について
| ご質問 | 回答 |
|---|---|
| 「アプリケーションID」はどこで確認ができますか？ | お申し込みをしていただいたYahoo! JAPAN IDでログインした状態で下記ページをご確認ください。 【アプリケーションの管理】 https://e.developer.yahoo.co.jp/dashboard/ |
| IPアドレスの追加・変更をしたい。 | お手数をお掛けしますが、再申請をお願い致します。 （IPの部分は追加分の情報のみで問題ございません。） Yahoo!デベロッパーネットワーク ショッピングAPI利用申請 |
| 設定完了の連絡が来ない。 | 設定完了まで約1週間〜10日程度お時間をいただく場合がございます。 設定完了後、申請時に入力した"メールアドレス"宛に通知がされます。 |
| 申請時に入力した"IPアドレス"を確認できますか? | 恐れ入りますが、利用者様のほうで確認をできるページ等は用意しておりません。 お手数をおかけしますが「お問い合わせ専用フォーム」からお問い合わせください。 |
「注文API」「問い合わせ管理API」の証明書について
その他「証明書」に関するヘルプはこちらをご確認ください。
| ご質問 | 回答 |
|---|---|
| 証明書はどこからダウンロードできますか？ | ストアクリエイタProトップのページ上部にダウンロードボタンが表示されます。 管理者権限を持った方のみダウンロードが可能です。 |
| 「ダウンロード」ボタンが表示されません。 | 管理者権限を持った方のみダウンロードが可能です。 |
| ダウンロードした後はどうすればいいですか？ | 下記ページのサンプルをご確認ください。 本番環境の注文・お問い合わせ管理APIの証明書による認証について ※「証明書によるリクエスト方法事例」にサンプルを記載しています。 |
| 有効期限切れ前にメールが来た。更新をするにはどうしたらいいですか? | 自動更新されますので、別途申請は不要です。 |
| 利用中の証明書の有効期限はいつまでですか？ | 恐れ入りますが、有効期限を確認するページ等は用意しておりません。 期限切れ1,2か月前の2回メールで告知を行っております。 |
| ダウンロードしたファイルが開くことができません。 | ダウンロードしていただいたファイルは開いて確認する必要はありません。 （開いて内容が確認できるものではありません。） |
| ヘルプページのサンプルを確認しましたが、更新方法がわかりません。 | 現在利用中の証明書ファイルと置き換えだけです。 ※コマースパートナ提供のツールをご利用中の場合は、ツール提供元の指示に従って設定をしてください。 |
エラーについて
| ご質問 | 回答 |
|---|---|
| 「Your Request was Forbidden」が返ってくる。 | 原因として以下3点が考えられます。 |
| 「od91008」が返ってくる。 |
※注文ステータス変更API(orderStatusChange)にリクエストしている場合 出荷ステータス更新API(orderShipStatusChange)を実行した直後に 注文ステータス変更API(orderStatusChange)にリクエストすると、こちらのエラーが発生する可能性があります。 出荷ステータス更新APIを実行した場合は、実行後しばらく時間をおいてから注文ステータス変更APIを実行してください。 |
テスト環境（sandbox）について
| ご質問 | 回答 |
|---|---|
| ストアアカウントを確認したい。 | ストアアカウントは設定完了メールに記載しております。 件名：【重要】テスト環境利用申請者の方へご案内：Yahoo!ショッピング |
| エラーが出てテスト注文ができません。 | 「反映」実施してください。 未反映項目がない場合は、反映項目を発生させてから「反映」をお願いします。 |
| FTPサーバは利用できますか？ | テスト環境についてはFTPサーバを用意しておりません。 |
| テスト用のクレジットカードはありますか？ | Yahoo!デベロッパーネットワーク（ショッピング） ページ上部にある「Yahoo!ショッピングAPIマニュアル（pdf）」のP.71をご確認ください。 |
| 「ポイント」を利用した注文はできますか？ | テスト環境では「ポイント」の付与・利用ができないようになっております。 その他、本番環境との仕様の違いはこちらのページに記載しております。 |
| 「クーポン」を利用した注文はできますか？ | テスト環境では「クーポン」の発行・利用ができないようになっております。 その他、本番環境との仕様の違いはこちらのページに記載しております。 |
その他
| ご質問 | 回答 |
|---|---|
| サンプルコードはありませんか？ | PHP版のサンプルコードをご用意しております。 ■ 注文API https://developer.yahoo.co.jp/webapi/shopping/order/sample.html ■ 商品API https://developer.yahoo.co.jp/webapi/shopping/item/sample.html ■ 在庫API https://developer.yahoo.co.jp/webapi/shopping/stock/sample.html ■ 画像API https://developer.yahoo.co.jp/webapi/shopping/image/sample.html ※随時追加をさせていただきます。 |
| サーバを移管しました。 必要な対応はありますか？ |
注文・お問い合わせ管理APIを利用していて、リクエスト元IPアドレスに変更がある場合のみ申請をお願いします。 下記ページからお申し込みください。（新IPをご入力ください。） 注文・お問い合わせ管理API利用申請フォーム |
