用于测试的应用提交API

用于测试的应用提交API是一种REST API，允许您以编程方式为亚马逊应用商店DevTest注册应用并添加测试者。

在使用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) 的亚马逊应用商店DevTest。

请求

要为您的应用注册适用于IAP的亚马逊应用商店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，您将在添加测试者请求中使用它。出现错误时，响应会返回相应的HTTP状态码，并包括带有错误代码和人类可读消息的响应正文。

响应正文示例

{
    "trackId": "devtest"
}

响应正文属性

参数	描述	类型
`trackId`	标识应用的轨迹。对于DevTest，值为`devtest`。	字符串

HTTP状态码

状态	描述
`200 OK`	应用已成功注册DevTest。
`404 Not Found`	未找到请求的资源。
`400 Bad Request`	表示请求正文中的一个或多个属性无效或不存在。

将测试者添加到适用于IAP的DevTest

将测试者添加到DevTest环境中以进行IAP测试。

请求

要将测试者添加到适用于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`	测试者的电子邮件地址。	字符串	是

响应

成功的响应返回HTTP 200 OK，包括添加的测试者分组列表以及各组中唯一测试者的数量。出现错误时，响应会返回相应的HTTP状态码，并包括带有错误代码和人类可读消息的响应正文。

响应正文示例

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

响应正文属性

参数	描述	类型
`groups`	添加到此应用的DevTest注册中的测试者分组名称的列表。	List<String>
`uniqueTesterCount`	在测试者分组中添加的唯一测试者的数量。	整数

HTTP状态码

状态	描述
`200 OK`	测试者已成功添加到应用的DevTest。
`404 Not Found`	未找到请求的资源。
`400 Bad Request`	表示请求正文中的一个或多个属性无效或不存在。

对象定义

用于测试的应用提交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`	测试者的电子邮件地址。	字符串

Last updated: 2025年5月22日