外部系统更新测试用例
功能介绍
外部系统更新测试用例
调用方法
请参见如何调用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",
"result" : {
"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 |
错误码
请参见错误码。