目录

新建测试版本

功能介绍

此接口用于创建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)

是否进行上架自检。

取值范围:

  • 0:否。
  • 1:是。
说明:
  • 选择“是”,将提交邀请测试并按照正式上架的审核要求自检,上架自检预计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"
}