Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
テスト用アプリ申請APIは、Appstore DevTestへのアプリの登録とテスターの追加をプログラムから実行できるREST APIです。 APIを使用する前に、アクセス権を設定し、OAuthセッショントークンを取得する必要があります。このトークンを各APIリクエストのHTTPヘッダーに含めます。

ベースURL

テスト用アプリ申請APIのベースURLは、developer.amazon.com/api/appstoreです。

認証

テスト用アプリ申請APIへのアクセスを構成するには、まず開発者コンソールでセキュリティプロファイルを作成し、APIに関連付ける必要があります。次に、Login with Amazon APIを使用してアクセストークンをリクエストし、そのトークンを各APIリクエストのHTTPヘッダーに追加します。

セキュリティプロファイルの作成

APIを使用する前に、セキュリティプロファイルを作成する必要があります。セキュリティプロファイルは、APIへのアクセスに使用するアクセストークンを生成します。 セキュリティプロファイルを作成するには
  1. Amazon開発者コンソールのアカウントにログインします。
  2. 上部のナビゲーションから、[ツール&サービス] > [APIアクセス] の順にクリックします。
  3. [アプリ申請API] をクリックします。
  4. [セキュリティプロファイルを新規作成] をクリックします。
  5. 新しいプロファイルの [セキュリティプロファイル名] と [セキュリティプロファイルの説明] を入力し、[保存] をクリックします。
  6. [ウェブ設定] タブから、クライアントIDとクライアントシークレットを保存します。APIにアクセスするには、この情報が必要です。 クライアントIDとクライアントシークレット

セキュリティプロファイルとAPIの関連付け

セキュリティプロファイルを作成したら、開発者コンソールでAPIに関連付ける必要があります。 セキュリティプロファイルをAPIに関連付けるには
  1. [ツール&サービス] > [APIアクセス] の順にクリックして、[APIアクセス] ページに移動します。
  2. API名をクリックしてパネルを展開します。
  3. ドロップダウンリストから、前のセクションで作成したセキュリティプロファイルを選択します。
  4. [関連付ける] をクリックして、セキュリティプロファイルをこのAPIに関連付けます。[使用中のセキュリティプロファイル] パネルに、API名と、関連付けられたセキュリティプロファイルが追加されます。 セキュリティプロファイルを添付
これで、クライアントIDとクライアントシークレットを使用して、Amazonでログイン(LWA)アクセストークンをリクエストできるようになりました。

LWAアクセストークンのリクエスト

クライアントIDとクライアントシークレットを取得したら、以下の手順に従って、Login with Amazon APIを使用してLogin with Amazonアクセストークンをリクエストします。

トークンリクエストを送信する

次のヘッダーとコンテンツを使用して、https://api.amazon.com/auth/o2/tokenにPOSTリクエストを送信します。
  • ヘッダー:Content-Type: application/x-www-form-urlencoded
  • コンテンツ:
JSONコンテンツの例:
cURLリクエストの例:

レスポンスを保存する

レスポンスの例は次のとおりです。
  • access_token:アクセストークン
  • expires_in:アクセストークンの有効期限が切れるまでの秒数
  • scope:
  • token_type:常にbearer

エラーレスポンスを処理する

トークンリクエストでエラーが発生した場合、レスポンスのメッセージ本文には次のエラーメッセージのいずれかが含まれます。
エラーメッセージ本文詳細
{"error_description":"Client authentication failed","error":"invalid_client"}無効なシークレットキー
{"error_description":"The request has an invalid parameter : scope","error":"invalid_scope"}無効な範囲の値
{"error_description":"The authorization grant type is not supported by the authorization server","error":"unsupported_grant_type"}無効な認可グラントタイプ
{"error_description":"The Content-Type is not supported by the authorization server","error":"invalid_request"}サポート対象外のContent-Type

アクセストークンの使用方法

まず、アクセストークンを保存します。アクセストークンは、LWAアクセストークンのリクエストのレスポンスに含まれているaccess_tokenフィールドの値です。 APIにリクエストを送信するときは、AuthorizationヘッダーにBearer <YOUR_ACCESS_TOKEN>という値を設定します。アクセストークンは、「Atc|」で始まる長い文字列です。 cURLリクエストの例:
アクセストークンの有効期限が切れた場合は、LWAアクセストークンのリクエストの手順に従って新しいトークンを取得し、それを使用してリクエストを送信します。アクセストークンを最後にリクエストしてから1時間以上経過すると、403 Forbidden HTTPエラーとなり、「Request is not authorized(リクエストが認可されていません)」というメッセージが表示されるようになります。これは、アクセストークンの有効期限が切れたことを示します。

操作

テスト用アプリ申請APIには、次の操作が含まれています。
操作HTTPメソッドとURI
アプリの登録POST /{apiVersion}/applications/{appId}/devtest/register
テスターの追加POST /{apiVersion}/applications/{appId}/tracks/{trackId}/testers

アプリの登録

アプリ内課金(IAP)用Appstore DevTestにアプリを登録します。

リクエスト

IAP用Appstore DevTestにアプリを登録するには、/{apiVersion}/applications/{appId}/devtest/registerエンドポイントにPOSTリクエストを送信します。リクエスト本文には、アプリのパッケージ名と、アプリの署名に使用する証明書を指定します。

リクエストの例

リクエストパラメーター

パラメーター指定場所説明型必須
apiVersionパスAPIのバージョン。現在はv1です。文字列○
appIdパスアプリの識別子。たとえば、amzn1.devportal.mobileapp.dde7ec787b031584aa5f04606184041aのような文字列です。文字列○
access tokenヘッダーLWAトークン。文字列○

リクエスト本文の例

リクエスト本文のプロパティ

パラメーター説明型必須
packageNameアプリのパッケージ名。文字列○
certificateアプリの署名に使用する証明書。文字列○

レスポンス

正常に完了すると、HTTP 200 OKと共に、trackIdがレスポンスで返されます。このIDをテスターの追加リクエストで使用します。エラーが発生した場合は、適切なHTTPステータスコードがレスポンスとして返され、エラーコードと人が判読できるメッセージがレスポンス本文に追加されます。

レスポンス本文の例

レスポンス本文のプロパティ

パラメーター説明型
trackIdアプリのトラックを識別します。DevTestの場合、この値はdevtestになります。文字列

HTTPステータスコード

ステータス説明
200 OKアプリがDevTestに正常に登録されました。
404 Not Found指定されたリソースが見つかりません。
400 Bad Requestリクエスト本文の1つ以上のプロパティが無効であるか存在しないことを示します。

IAP用DevTestへのテスターの追加

IAPのテストのために、DevTest環境にテスターを追加します。

リクエスト

IAP用DevTestにテスターを追加するには、/{apiVersion}/applications/{appId}/tracks/{trackId}/testersエンドポイントにPOSTリクエストを送信します。リクエストには、登録時のレスポンスで返されたtrackIdを使用する必要があります。さらに、テスターの追加先となるテスターグループ名と、テスターの詳細も指定する必要があります。

リクエストの例

リクエストパラメーター

パラメーター指定場所説明型必須
apiVersionパスAPIのバージョン。現在はv1です。文字列○
appIdパスアプリの識別子。たとえば、amzn1.devportal.mobileapp.dde7ec787b031584aa5f04606184041aのような文字列です。文字列○
access tokenヘッダーLWAトークン。文字列○

リクエスト本文の例

リクエスト本文のプロパティ

パラメーター説明型必須
groupsテスターグループのリスト。List<TesterGroup>○
nameテスターグループの名前。文字列○
testersテスターのリスト。List<Tester>○
firstNameテスターの名。文字列なし
lastNameテスターの姓。文字列なし
emailテスターのEメールアドレス。文字列○

レスポンス

正常に完了すると、HTTP 200 OKが返され、追加されたテスターグループのリストと、すべてのグループ間でのユニークテスターの数がレスポンスに含まれます。エラーが発生した場合は、適切なHTTPステータスコードがレスポンスとして返され、エラーコードと人が判読できるメッセージがレスポンス本文に追加されます。

レスポンス本文の例

レスポンス本文のプロパティ

パラメーター説明型
groupsこのアプリのDevTest登録に追加されたテスターグループ名のリスト。List<String>
uniqueTesterCountテスターグループ全体で追加されたユニークテスターの数。整数

HTTPステータスコード

ステータス説明
200 OKテスターがアプリのDevTestに正常に追加されました。
404 Not Found指定されたリソースが見つかりません。
400 Bad Requestリクエスト本文の1つ以上のプロパティが無効であるか存在しないことを示します。

オブジェクト定義

テスト用アプリ申請APIでは、次のオブジェクトが使用されます。

TesterGroupオブジェクト

TesterGroupオブジェクトは、テスターグループの名前とテスターのリストを格納します。
パラメーター説明型
nameテスターグループの名前。文字列
testersテスターのリスト。List<Tester>

Testerオブジェクト

Testerオブジェクトは、テスターの詳細を格納します。
パラメーター説明型
firstNameテスターの名。文字列
lastNameテスターの姓。文字列
emailテスターのEメールアドレス。文字列

最終更新日 2025年9月30日