TestHub采用华为云IAM认证鉴权与注册的测试工具的接口进行交互。
TestHub在调用新测试类型服务接口时，使用用户登录软件开发平台后的IAM Token信 息。
如果是通过APIG方式进行接口调用，测试工具需将自己的接口发布到华为云APIG上并 对云测授权。
创建用例
● 接口描述
– 功能介绍：TestHub调用测试工具此接口创建测试用例
– 请求方式：POST – 请求URL：
{服务域名}/v1/testcase – 请求头：
"Content-Type": "application/json; charset=UTF-8",
"Accept-Language": "zh-cn"
● 请求参数
字段 含义 类型 长度 是否必填
name 用例名称 String 大于3小于
128 是
project_uuid 软件开发平台项 目的唯一标识
String 32 是
case_id 用例唯一标识 String 32 是
请求消息样例：
{ "name": "test01",
"project_uuid": "ec22e1930cc04e6c9e68cb978bc33e74", "case_id": "ec22e1930cc04e6c9e68cb978bc33e74"
}
result 操作成功返回的 信息
Object 不限 否 参数详细说明可参考•操作 成功返回信息
error 异常响应 Obje
ct 不限 否 参数详细说明可参考•异常 响应
响应消息样例：
{ "status": "success", "result": {
} }
更新用例
● 接口描述
– 功能介绍：TestHub调用测试工具此接口更新测试用例名称 – 请求方式：PUT
– 请求URL：
{服务域名}/v1/testcase
– 请求头：
"Content-Type": "application/json; charset=UTF-8",
"Accept-Language": "zh-cn"
● 请求参数
字段 含义 类型 长度 是否必填
name 用例名称 String 大于3小于
128 是
project_uuid 软件开发平台项
目的唯一标识 String 32 是
case_id 用例唯一标识 String 32 是
请求消息样例：
{ "name": "test02",
"project_uuid": "ec22e1930cc04e6c9e68cb978bc33e74", "case_id": "ec22e1930cc04e6c9e68cb978bc33e74"
}
result 操作成功返回的
信息 Obje
ct 不限 否 参数详细说明可参考•操作 成功返回信息
error 异常响应 Obje
ct 不限 否 参数详细说明可参考•异常 响应
响应消息样例：
{ "status": "success", "result": {
} }
删除用例
● 接口描述
– 功能介绍：TestHub调用测试工具此接口删除测试用例 – 请求方式：DELETE
– 请求URL：
{服务域名}/v1/testcase? project_uuid={projectUUId}&case_id={caseId}
– 参数说明
字段 含义
project_uuid 软件开发平台项目的唯一标识 case_id 用例唯一标识
– 请求头：
"Content-Type": "application/json; charset=UTF-8",
"Accept-Language": "zh-cn"
● 响应参数
result 操作成功返回的
信息 Obje
ct 不限 否 参数详细说明可参考•操作 成功返回信息
error 异常响应 Obje
ct 不限 否 参数详细说明可参考•异常 响应
响应消息样例：
{ "status": "success", "result": {
} }
执行用例
● 接口描述
– 功能介绍：TestHub调用测试工具此接口执行测试用例 – 请求方式：POST
– 请求URL：
{服务域名}/v1/testcase/execute – 请求头：
"Content-Type": "application/json; charset=UTF-8",
"Accept-Language": "zh-cn"
● 请求参数
字段 含义 类型 长度 是否必填
project_uuid 软件开发平台项
目的唯一标识 String 32 是
case_id 用例唯一标识 String 32 是
请求消息样例
{ "project_uuid": "ec22e1930cc04e6c9e68cb978bc33e74", "case_id": "ec22e1930cc04e6c9e68cb978bc33e74"
}
result 操作成功返回的
信息 Obje
ct 不限 否 参数详细说明可参考•操作 成功返回信息
error 异常响应 Obje
ct 不限 否 参数详细说明可参考•异常 响应
响应消息样例：
{ "status": "success", "result": {
"execute_id": "ec22e1930cc04e6c9e68cb978bc33e74"
} }
停止用例
● 接口描述
– 功能介绍：TestHub调用测试工具此接口停止执行测试用例 – 请求方式：POST
– 请求URL：
{服务域名}/v1/testcase/stop – 请求头：
"Content-Type": "application/json; charset=UTF-8",
"Accept-Language": "zh-cn"
● 请求参数
字段 含义 类型 长度 是否必填
project_uuid 软件开发平台项
目的唯一标识 String 32 是
case_id 用例唯一标识 String 32 是 execute_id 测试工具的执行id String 小于等于32 是
请求消息样例：
{ "project_uuid": "ec22e1930cc04e6c9e68cb978bc33e74", "case_id": "ec22e1930cc04e6c9e68cb978bc33e74", "execute_id": "ec22e1930cc04e6c9e68cb978bc33e74"
}
● 响应参数
result 操作成功返回的
信息 Obje
ct 不限 否 参数详细说明可参考•操作 成功返回信息
error 异常响应 Obje
ct 不限 否 参数详细说明可参考•异常 响应
响应消息样例
{ "status": "success", "result": {
} }
获取用例状态
● 接口描述
– 功能介绍：TestHub调用测试工具此接口获取测试用例某次执行状态 – 请求方式：POST
– 请求URL：
{服务域名}/v1/testcase/query/status – 请求头：
"Content-Type": "application/json; charset=UTF-8",
"Accept-Language": "zh-cn"
● 请求参数
字段 含义 类型 长度 是否必填
project_uuid 软件开发平台项
目的唯一标识 String 32 是
query_list 获取用例状态的
用例信息 List 小于等于50 是
其中，参数“query_list”说明如下：
字段 含义 类型 长度 是否必填
case_id 用例唯一标识 String 32 是 execute_id 标识用例某一次
执行的id String 小于等于32 是
请求消息样例
{ "project_uuid": "ec22e1930cc04e6c9e68cb978bc33e74", "query_list": [{
"case_id": "ec22e1930cc04e6c9e68cb978bc33e74", "execute_id": "ec22e1930cc04e6c9e68cb978bc33e74"
}, {
"case_id": "ec22e1930cc04e6c9e68cb978bc33e74", "execute_id": "ec22e1930cc04e6c9e68cb978bc33e74"
result 操作成功返回的 信息
Object 不限 否 参数详细说明可参考•操作 成功返回信息
error 异常响应 Obje
ct 不限 否 参数详细说明可参考•异常 响应
响应消息样例：
{ "status": "success", "result": {
"status_list": [{
"case_id": "ec22e1930cc04e6c9e68cb978bc33e"，
"execute_id": "ec22e1930cc04e6c9e68cb978bc33", "result": "5",
"case_id": "ec22e1930cc04e6c9e68cb978bc33e", "execute_id": "ec22e1930cc04e6c9e68cb978bc33", "result": "5",
字段 含义 类型 长度 备注 start_tim
e 用例开始执行时
间 long 不限 时间戳
end_time 用例结束执行时
间 long 不限 时间戳
duration 持续时间 long 不限 持续执行时长（单位：
ms）
result 执行结果 Strin
g 1 -1-未执行
执行记录id，唯一 Strin
g 小于等于