外部系统创建测试用例
功能介绍
外部系统创建测试用例
调用方法
请参见如何调用API。
URI
POST /v4/testhub/projects/{project_id}/testcases
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
用例名称 |
service_id |
否 |
Integer |
服务类型 |
rank_id |
否 |
String |
用例等级ID |
testcase_number |
否 |
String |
用例编号 |
version_uri |
否 |
String |
版本URI |
extend_info |
否 |
ExternalServiceBizCase object |
用例扩展信息 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
assigned_id |
否 |
String |
参数解释: 处理者id信息,长度0-32位 约束限制: 不涉及 取值范围: 0-32位字符 默认取值: 不涉及 |
defect_id_list |
否 |
Array of strings |
参数解释: 缺陷id信息,数组长度小于50个 约束限制: 不涉及 取值范围: 数组长度小于50 默认取值: 不涉及 |
description |
否 |
String |
参数解释: 测试用例描述信息,长度为[0-500]位字符 约束限制: 不涉及 取值范围: 0-500位字符 默认取值: 不涉及 |
fix_version_id |
否 |
String |
参数解释: 迭代号,长度为[0-32]位字符 约束限制: 不涉及 取值范围: 0-32位字符 默认取值: 不涉及 |
issue_id |
否 |
String |
参数解释: 用例关联的需求id信息,长度为[0-32]位字符 约束限制: 不涉及 取值范围: 0-32位字符 默认取值: 不涉及 |
label_list |
否 |
Array of strings |
参数解释: 标签名称列表,数组长度小于25 约束限制: 不涉及 取值范围: 数组长度小于25 默认取值: 不涉及 |
module_id |
否 |
String |
参数解释: 模块号,长度为[0-32]位字符 约束限制: 不涉及 取值范围: 0-32位字符 默认取值: 不涉及 |
preparation |
否 |
String |
参数解释: 执行该测试用例时需要满足的前置条件,长度为[0-500]位字符 约束限制: 不涉及 取值范围: 0-500位字符 默认取值: 不涉及 |
status_id |
否 |
String |
参数解释: 测试用例状态信息,(0-新建,5-设计中,6-测试中,7-完成) 约束限制: 不涉及 取值范围: 0-新建,5-设计中,6-测试中,7-完成 默认取值: 不涉及 |
steps |
否 |
Array of ExternalServiceCaseStep objects |
参数解释: 测试步骤,数组长度小于10 约束限制: 不涉及 取值范围: 数组长度小于10 默认取值: 不涉及 |
test_version_id |
否 |
String |
测试版本号,长度为[1-64]位字符 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
success|error |
error |
ApiError object |
错误信息 |
request_id |
String |
由接口调用方传入,建议使用UUID保证请求的唯一性。 |
server_address |
String |
本次请求的受理的服务地址 |
result |
ExternalQueryCaseVo object |
请求结果 |
参数 |
参数类型 |
描述 |
---|---|---|
testcase_id |
String |
用例id |
project_id |
String |
项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。 |
service_id |
Integer |
服务类型 |
name |
String |
名称 |
testcase_number |
String |
用例编号 |
rank_id |
Integer |
用例等级 |
status_id |
String |
用例状态 |
execute_count |
Integer |
用例结果数 |
result_id |
String |
用例结果 |
assigned_user |
NameAndIdVo object |
用例处理人信息 |
extend_info |
ExtendInfoVo object |
用例扩展信息 |
参数 |
参数类型 |
描述 |
---|---|---|
author |
UserBaseVo object |
作者 |
updator |
UserBaseVo object |
更新人 |
domain |
NameAndIdVo object |
domin |
preparation |
String |
前置条件 |
steps |
Array of TestCaseStepVo objects |
用例测试步骤和预期结果 |
module |
NamePathAndPathVo object |
用例模块信息 |
issue |
NameAndIdVo object |
用例关联需求信息 |
description |
String |
备注 |
label_list |
Array of NameAndIdVo objects |
用例标签信息 |
defect_list |
Array of NameAndIdVo objects |
用例tracker信息 |
fixed_version |
NameAndIdVo object |
用例版本信息 |
test_version_id |
String |
版本号 |
参数 |
参数类型 |
描述 |
---|---|---|
test_step |
String |
测试步骤 |
expect_result |
String |
预期结果 |
step_actual |
String |
步骤的实际结果 |
step_result |
String |
步骤结果 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
ID |
name |
String |
名称 |
path |
String |
路径id |
path_name |
String |
模块路径名称 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
请求示例
post https://{endpoint}/v4/testhub/projects/a5eb0d410ea341a192f7c12483568985/testcases { "name" : "用例1", "service_id" : 0, "rank_id" : "1", "testcase_number" : "123", "version_uri" : "v90100010gpop318", "extend_info" : { } }
响应示例
状态码:200
OK
{ "status" : "success", "result" : { "testcase_id" : "001rvc8k178", "project_id" : "0000dbab7df44231a72bfa25a1259c73", "service_id" : 3, "name" : "用例", "testcase_number" : "用例编号:-Copy-bbe028df", "rank_id" : 2, "status_id" : "4sfsd82e", "execute_count" : 1, "result_id" : "4sfsd82e", "assigned_user" : { }, "extend_info" : { } } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。