外部系统更新测试用例
功能介绍
外部系统更新测试用例
调用方法
请参见如何调用API。
URI
PUT /v4/testhub/projects/{project_id}/testcases/{testcase_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。 |
testcase_id |
是 |
String |
用例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 |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
请求示例
put https://{endpoint}/v4/testhub/projects/a5eb0d410ea341a192f7c12483568985/testcases/v80b00010i5dji80 { "uri" : "v92s00010hovp2cp", "type" : "TestCase", "author" : "cba378b8db4f4b6da3a5f01abd68ebe6", "name" : "qqqqqqqqqqq", "rank" : 2, "stage" : "1", "designer" : "cba378b8db4f4b6da3a5f01abd68ebe6", "region" : "cn-north-7", "iteratorCreateError" : false, "issue" : { "id" : "1142109792117891073", "name" : "1", "path" : "1142109792117891073", "tracker_name" : "IR" }, "last_modifier" : "cba378b8db4f4b6da3a5f01abd68ebe6", "last_modified" : "2025-06-11 19:19:02", "last_modified_timestamp" : 1749640742000, "last_change_time" : "2025-06-11 19:19:02", "version_uri" : "v92t00010g2edrt1", "parent_uri" : "v92s00010g2ebga6", "parent_path" : "/db9851fc9d09438c8577f90fd7915ade/v92s00010g2ebga6/", "creation_version_uri" : "v92s00010g2ebga6", "creation_date" : "2025-06-11 19:19:02", "creation_date_timestamp" : 1749640742000, "author_name" : "妙啊", "number" : "106", "case_type" : 0, "platform_type" : 0, "service_type" : 0, "service_type_name" : "手工测试", "test_type" : 1, "test_type_name" : "功能性测试", "test_step_model" : "table", "test_step" : "[\"\"]", "expect_output" : "[\"\"]", "template_id" : "", "script_parameter" : "", "auto_type" : 0, "to_be_auto_exec" : 0, "feature_name" : "其他", "dr_relation_id" : "1142109792117891073", "dr_relation_id_list" : [ "1142109792117891073" ], "automatically_executed" : 0, "is_contract_testcase" : 0, "time_cost" : 0, "status_code" : "0", "labels" : [ ], "execute_times" : 0, "is_keyword" : 0, "project_uuid" : "db9851fc9d09438c8577f90fd7915ade", "testcase_uri" : "v92s00010hovp2cp", "last_modifier_name" : "cba378b8db4f4b6da3a5f01abd68ebe6", "issue_list" : [ { "id" : "1142109792117891073", "name" : "1", "path" : "1142109792117891073", "tracker_name" : "IR" } ], "steps" : [ { "test_step" : "", "expect_result" : "" } ], "feature_abs_path" : "特性目录/其他", "associate_defect" : true, "associate_issue" : true, "defect_list" : [ { "id" : "1131962464664985600", "name" : "1111" } ], "branch_uri" : "v92s00010g2ebga6", "branch_name" : "基线", "iterator_uri" : "v92t00010g2edrt1", "iterator_name" : "计划1", "issue_name" : "1", "issue_id" : "1142109792117891073", "result" : "", "remark" : "1", "label_names" : [ ], "release_dev" : "", "testStep" : "", "expectOutput" : "" }
响应示例
状态码:200
OK
{ "status" : "success", "value" : { "uri" : "v92s00010hovp2cp", "type" : "TestCase", "author" : "cba378b8db4f4b6da3a5f01abd68ebe6", "name" : "qqqqqqqqqqq", "rank" : 2, "remark" : "1", "stage" : "1", "designer" : "cba378b8db4f4b6da3a5f01abd68ebe6", "region" : "cn-north-7", "owner" : "", "iteratorCreateError" : false, "last_modifier" : "cba378b8db4f4b6da3a5f01abd68ebe6", "last_modified" : "2025-06-19 15:48:15", "last_change_time" : "2025-06-19 15:48:15", "version_uri" : "v92s00010g2ebga6", "parent_uri" : "v92s00010g2ebga6", "parent_path" : "/db9851fc9d09438c8577f90fd7915ade/v92s00010g2ebga6/", "creation_version_uri" : "v92s00010g2ebga6", "creation_date" : "2025-06-11 19:17:52", "number" : "106", "case_type" : 0, "platform_type" : 0, "service_type" : 0, "test_type" : 1, "test_step" : "[\"\"]", "expect_output" : "[\"\"]", "template_id" : "", "script_parameter" : "", "auto_type" : 0, "to_be_auto_exec" : 0, "dr_relation_id" : "1142109792117891073", "automatically_executed" : 0, "is_contract_testcase" : 0, "time_cost" : 0, "status_code" : "0", "label_id" : "", "execute_times" : 0, "is_keyword" : 0, "project_uuid" : "db9851fc9d09438c8577f90fd7915ade", "creation_version_name" : "基线" } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。