功能介绍
此接口用于创建HarmonyOS应用/元服务的测试版本。
接口调用者的角色:账号持有者、管理员、APP管理员、运营。
接口原型
承载协议 | HTTPS POST |
接口方向 | 开发者服务器 -> 华为服务器 |
接口URL | https://connect-api.cloud.huawei.com/api/publish/v2/test/app/version |
数据格式 | 请求:Content-Type: application/json 响应:Content-Type: application/json |
[h2]Header
本接口支持使用Service Account方式和API客户端方式,区别请参见获取服务端授权。
Service Account方式:
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
Authorization | M | String | 认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。 |
API客户端方式:
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
client_id | M | String | 客户端ID,获取方法参考创建API客户端。 |
Authorization | M | String | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
[h2]Query
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
appId | M | String | 应用ID。 |
[h2]Body
请求Body中使用JSON格式携带添加的测试版本信息,参数如下表所示。
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
releaseType | M | Integer(32) | HarmonyOS测试发布方式(API>=10)。 默认值:6 |
testType | M | Integer(32) | 测试类型。 取值范围: - 3:HarmonyOS邀请测试。
- 4:HarmonyOS公开测试。
|
testDesc | M | String(50) | 测试版本描述。 最长50个字符。 |
onshelfSelfDetect | O | Integer(32) | 是否进行上架自检。 取值范围: 说明: - 选择“是”,将提交邀请测试并按照正式上架的审核要求自检,上架自检预计1天内完成。
- 选择“否”,将仅提交邀请测试审核,不进行正式上架自检。
- 上架自检不影响您邀请测试的上架结果。
- 一个应用有且仅支持存在一个上架自检中的任务,若存在上架自检中的任务时,再次创建邀请测试,该字段设置无效。
|
请求示例
POST /api/publish/v2/test/app/version?appId=10****47 HTTP/1.1
Host: connect-api.cloud.huawei.com
client_id: 4141******68
Content-Type: application/json
Authorization: Bearer *******
{
"releaseType": 6,
"testType": 3,
"testDesc": "测试版本描述demo",
"onshelfSelfDetect": 1
} 响应参数
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
ret | M | ConnectRet | 包含返回码及描述信息的结果。 |
versionId | O | String | 测试版本ID。 |
响应示例
{
"ret": {
"code": 0,
"msg": "success"
},
"versionId": "17*********8710"
}