テスト用アプリ申請API

テスト用アプリ申請APIは、Appstore DevTestへのアプリの登録とテスターの追加をプログラムから実行できるREST APIです。

APIを使用する前に、アクセス権を設定し、OAuthセッショントークンを取得する必要があります。このトークンを各APIリクエストのHTTPヘッダーに含めます。

ベースURL
認証
操作
アプリの登録
IAP用DevTestへのテスターの追加
オブジェクト定義

ベースURL

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

認証

APIへのアクセスを構成するには、アプリ申請APIドキュメントのAPI認証の手順に従ってください。

操作

テスト用アプリ申請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リクエストを送信します。リクエスト本文には、アプリのパッケージ名と、アプリの署名に使用する証明書を指定します。

リクエストの例

POST /{apiVersion}/applications/{appId}/devtest/register
Host: developer.amazon.com/api/appstore
Content-Type: application/json
Authorization: Bearer {access token}

リクエストパラメーター

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

リクエスト本文の例

{
    "packageName": String,
    "certificate": String
}

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

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

レスポンス

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

レスポンス本文の例

{
    "trackId": "devtest"
}

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

パラメーター	説明	型
`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を使用する必要があります。さらに、テスターの追加先となるテスターグループ名と、テスターの詳細も指定する必要があります。

リクエストの例

POST /{apiVersion}/applications/{appId}/tracks/{trackId}/testers
Host: developer.amazon.com/api/appstore
Content-Type: application/json
Authorization: Bearer {access token}

リクエストパラメーター

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

リクエスト本文の例

{
    "groups": [{
        "name": String,
        "testers": [{
            "firstName": String,
            "lastName": String,
            "email": String
        }]
    }]
}

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

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

レスポンス

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

レスポンス本文の例

{
    "groups": List<String>,
    "uniqueTesterCount" : Integer
}

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

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

HTTPステータスコード

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

オブジェクト定義

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

TesterGroupオブジェクト

TesterGroupオブジェクトは、テスターグループの名前とテスターのリストを格納します。

{
    "name": String,
    "testers": [{
        "firstName": String,
        "lastName": String,
        "email": String
    }]
}

パラメーター	説明	型
`name`	テスターグループの名前。	文字列
`testers`	テスターのリスト。	List<Tester>

Testerオブジェクト

Testerオブジェクトは、テスターの詳細を格納します。

{
    "firstName": String,
    "lastName": String,
    "email": String
}

パラメーター	説明	型
`firstName`	テスターの名。	文字列
`lastName`	テスターの姓。	文字列
`email`	テスターのEメールアドレス。	文字列

Last updated: 2025年5月22日