目录

生成邀请码

功能介绍

此接口用于邀请测试生成邀请码。

接口原型

承载协议

HTTPS POST

接口方向

服务商服务器 -> 华为服务器

接口URL

https://connect-api.cloud.huawei.com/api/app-test/v1/invitation-code

数据格式

请求：Content-Type: application/json

响应：Content-Type: application/json

请求参数

[h2]Header

参数名称

必选(M)/可选(O)

类型

参数说明

client_id

M

String

API客户端ID。

创建第三方平台成功后系统自动分配的客户端ID，可在第三方管理平台“开发配置 > 开发资料设置”页面中获取，详情请参见获取平台访问凭据。

Authorization

M

String

认证信息，格式为“Authorization: Bearer ${access_token}”。access_token为获取平台级Token中获取的access_token。

appId

M

String

应用ID

[h2]Body

请求Body中使用JSON格式携带邀请码信息，参数如下表所示。

参数名称

必选(M)/可选(O)

类型

参数说明

groupId

M

String(32)

测试群组ID。

invitationCodeValidDays

M

Integer(32)

邀请码有效期，单位天，目前只支持30天。

invitationCodeInviteLimit

M

Integer(32)

邀请码可邀请人数上限，最大值10000。

请求示例

 POST /api/app-test/v1/invitation-code HTTP/1.1 
 Host: connect-api.cloud.huawei.com 
 client_id: 4141******68 
 Content-Type: application/json 
 Authorization: Bearer ******* 
 appId: 6917********65
 {
   "groupId": "761e********08",
   "invitationCodeValidDays": 7,
   "invitationCodeInviteLimit": 1000
 }

响应参数

参数名称

必选(M)/可选(O)

类型

参数说明

rtnCode

M

String

返回码。

取值范围：

  • 0：成功
  • 1：参数校验不通过。
  • 2：越权错误。
  • -1：内部异常。

rtnDesc

O

String

返回码描述信息。

businessCode

O

String

业务错误码。

取值范围：

  • 100：测试群组已存在生效邀请码。
  • 101：测试群用户数量已达上限。

invitationCode

O

String

邀请码。

invitationCodeId

O

String

邀请码ID。

响应示例

{
  "rtnCode": 0,
  "rtnDesc": "success",
  "businessCode": 0,
  "invitationCode": "1f******ll",
  "invitationCodeId": "2697**********43"
}