Amazon MWSAuthToken使用ガイド 2 Amazon MWSAuthToken使用ガイド 2 目次 Amazon MWSAuthToken使用ガイド............................................................................................................. 3 Amazon MWSの認証トークンについて.......................................................................................................... 4 GetAuthToken................................................................................................................................................. 5 説明..............................................................................................................................................................................................................5 リクエストパラメータ................................................................................................................................................................................. 5 レスポンス要素............................................................................................................................................................................................6 例................................................................................................................................................................................................................. 6 関連トピック............................................................................................................................................................................................... 7 Amazon MWSAuthToken使用ガイド 2 3 Amazon MWSAuthToken使用ガイド 3 Amazon MWSAuthToken使用ガイド Copyright © -2014 Amazon.com, Inc. およびその関係者。AMAZONおよびAMAZON.COMはAmazon.com, Inc.またはその関係者の登録商標です。その他のすべての商標は、それぞれの所有者に帰属します。最終更新: 2014-08-19 Amazon MWSAuthToken使用ガイド 3 4 Amazon MWSAuthToken使用ガイド 4 Amazon MWSの認証トークンについて 2014年8月19日より、Amazon マーケットプレイスWebサービス (Amazon MWS)を介してあなたのウェブアプリケーションや開発者を認証するすべての出品者は、SellerIdとMarketplaceIdを取得するページで認証トークンを受け取ることになりました。この認証トークンは、特定のAmazonの出品者による各ウェブアプリケーション開発者への認証を表しています。これによりすべてのAmazon MWSオペレーションで、追加のリクエストパラメータとしてMWSAuthTokenが受け入れられるようになります。2015年3月30日までリクエストにこのMWSAuthTokenパラメータを追加することは任意となりますが、Amazon MWS2015年3月31日以降は、お使いのアプリケーションがウェブアプリケーションであれば、すべてのAmazon MWSリクエストでこのリクエストパラメータの追加が必要になります。必須のリクエストパラメータの詳細については、Amazon MWS 開発者ガイドの「必須リクエストパラメータ」を参照してください。 2015年3月31日まで、別の出品者があなたのウェブアプリケーションを認証する際にこの認証トークンをあなたに送信できるように、ウェブアプリケーションを更新しておく必要があります。また、追加トークンについての指示を、出品者に必ず通知しておいてください。Amazon MWSの登録方法の詳細については、Amazon MWS 開発者ガイドの「Amazon MWS 利用への登録」を参照してください。あなたのウェブアプリケーションや開発者をすでに認証している出品者に対しては、GetAuthTokenオペレーションにより認証トークンを取得することができます。このオペレーションにより、特定のAmazonの出品者による各ウェブアプリケーション開発者への認証を表すMWSAuthTokenが返されます。対象の出品者および開発者用の認証トークンがすでに存在している場合、このトークンはそのまま返されます。対象の出品者および開発者用の認証トークンがまだ存在していない場合は、作成されて返されます。ウェブアプリケーションを開発した場合、必ず2015年3月30日までにこのオペレーションを呼び出して、既存の出品者用の認証トークンを取得する必要があります。2015年3月31日以降、このオペレーションは利用できなくなります。詳細については、「GetAuthToken」を参照してください。 Note: Amazon MWS クライアントライブラリはまだ更新されていないため、 MWSAuthToken リクエストパラメーターを受け入れることができませんが、今後約 1 ヶ月以内に更新する予定です。クライアントライブラリが更新後、本ガイドも更新いたします。 Amazon MWS クライアントライブラリを使用していない場合は、ご自身のコードの更新を開始いただけます。 Amazon MWS Scratchpad を使用して必要な認証トークンを取得することも可能です。 Amazon MWS Scratchpad を使用する場合は、 API Section のドロップダウンリストから Sellers を選択し、 Operation ドロップダウンリストから GetAuthToken を選択します。 Amazon MWSAuthToken使用ガイド 4 5 5 Amazon MWSAuthToken使用ガイド GetAuthToken 対象の出品者とウェブアプリケーション開発者用のMWSAuthTokenを返します。説明 GetAuthTokenオペレーションにより、対象の出品者とウェブアプリケーション開発者用の認証トークン（MWSAuthToken）が返されます。対象の出品者および開発者用の認証トークンがすでに存在している場合、このトークンはそのまま返されます。対象の出品者および開発者用の認証トークンがまだ存在していない場合は、作成されて返されます。 Important: 必ず2015年3月30日までにこのオペレーションを呼び出して、既存のセラー用の承認トークンを取得する必要があります。2015年3月31日以降、このオペレーションは利用できなくなります。リクエストをGetAuthTokenオペレーションに送信する際は、次のエンドポイントを使用してください。https://mws.amazonservices.com/Sellers/2011-07-01 オペレーションの最大リクエストクォータは1回で、回復レートは10秒毎につき1リクエストです。スロットリングの詳細情報に関しては、Amazon MWS 開発者ガイドの「スロットリング: リクエストを送信できる頻度を制限する」を参照してください。リクエストパラメータ名前説明必須有効な値 AWSAccessKeyId Amazon MWSアカウントはアクセスキーIDによって識別され、Amazon MWSが秘密キーを検索するために使用します。はい Amazon MWS登録時に受信したAWSAccessKeyId。はい Action 値: タイプ: xs:string Action エンドポイントで実行するアクション。 • GetAuthToken タイプ: xs:string SellerId 承認トークン作成対象のセラーID。はいあなたのアプリケーションを承認済みのすべてのセラー。はい署名の計算方法の詳細については、Amazon MWS 開発者ガイドのを参照してください。はい SignatureMethod 値: タイプ: xs:string Signature リクエストの送信者を識別して確認するための認証プロセスの一部です。タイプ: xs:string SignatureMethod 署名の計算に使用するHMACハッシュアルゴリズム。HmacSHA256とHmacSHA1はハッシュアルゴリズムに対応していますが、AmazonはHmacSHA256を使用することを推奨しています。 • • HmacSHA256 (推奨) HmacSHA1 タイプ: xs:string Amazon MWSAuthToken使用ガイド 5 6 6 Amazon MWSAuthToken使用ガイド名前説明必須有効な値 SignatureVersion 使用されている署名のバージョン。Amazon MWSに固有の情報であり、署名の元となる文字列を形成するのに使用したアルゴリズムをAmazon MWSに伝えるものです。はい SignatureVersion値: • 2 タイプ: xs:string Timestamp 各リクエストには、リクエストのタイムスタンプが含まれている必要があります。使用中のAPI機能によっては、タイムスタンプの代わりに、リクエストの有効期限日と時間を指定することができます。ISO 8601形式。はい現在の日時またはリクエストのISO 8601形式の有効期限の日時。はい Version 値: タイプ: xs:dateTime Version 呼び出すAPIセクションのバージョン。 • 2011-07-01 タイプ: xs:string レスポンス要素名前説明 SellerId このAmazon MWSの認証トークンが適用されるセラーID タイプ: xs:string MWSAuthToken パラメーターに設定された出品者と開発者のAmazon MWSの認証トークンタイプ: xs:string 例クエリリクエスト例 https://mws.amazonservices.com/Sellers/2011-07-01 ?AWSAccessKeyId=AKIAEEXAMPLENGQCJLSA &Action=GetAuthToken &SellerId=A135KEXAMPLE56 &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2014-09-01T16%3A41%3A16Z &Version=2011-07-01 &Signature=vRBxMEXAMPLES2y0FGPufG4u7WY2HqhcsYUW6IVI9%2BQ%3D レスポンス例 <?xml version="1.0"?> <GetAuthTokenResponse xmlns="https://mws.amazonservices.com/ Sellers/2011-07-01"> <GetAuthTokenResult> <SellerId>A135KEXAMPLE56</SellerId> Amazon MWSAuthToken使用ガイド 6 7 Amazon MWSAuthToken使用ガイド 7 <MWSAuthToken>amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE</ MWSAuthToken> </GetAuthTokenResult> </GetAuthTokenResponse> 関連トピック Amazon MWSの認証トークンについて Amazon MWSAuthToken使用ガイド 7