外部系统更新测试用例 - UpdateCase
功能介绍
此接口用于外部系统调用,在指定项目下对指定测试用例进行更新操作,并返回更新后的用例详情数据
调用方法
请参见如何调用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-20000]位字符 约束限制: 不涉及 取值范围: 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 |
参数解释: 测试步骤,数组长度小于等于100 约束限制: 不涉及 取值范围: 数组长度小于10 默认取值: 不涉及 |
|
test_version_id |
否 |
String |
测试版本号,长度为[1-64]位字符 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
testcase_id |
String |
用例id |
|
project_id |
String |
项目ID |
|
service_id |
String |
服务类型 |
|
name |
String |
名称 |
|
testcase_number |
String |
用例编号 |
|
rank_id |
String |
用例等级 |
|
status_id |
String |
用例状态 |
|
execute_count |
Integer |
用例结果数 |
|
result_id |
Integer |
用例结果 |
|
assigned_user |
String |
用例处理人信息 |
|
extend_info |
Object |
用例扩展信息 |
状态码: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/9c115c0e26ee492386cfa408f7e8ed92/testcases/v90510sa530ad5pe
{
"name" : "qqqqqqqqqqq",
"rank_id" : "2",
"testcase_number" : "v92s00010hovp2cp",
"service_id" : 100
}
响应示例
状态码:200
OK
{
"testcase_id" : "v90510sa530ad5pe",
"project_id" : "9c115c0e26ee492386cfa408f7e8ed92",
"service_id" : 100,
"name" : "qqqqqqqqqqq",
"testcase_number" : "v92s00010hovp2cp",
"rank_id" : 2,
"status_id" : "0",
"execute_count" : 0,
"result_id" : "",
"assigned_user" : {
"id" : "",
"name" : ""
},
"extend_info" : {
"author" : {
"id" : "c217c42b8dfb4ac7bff52a87cbaca38c",
"name" : "昵称echotest_dl",
"time" : "2025-10-20 17:54:44"
},
"updator" : {
"id" : "c217c42b8dfb4ac7bff52a87cbaca38c",
"name" : "啊啊啊",
"time" : "2025-10-20 19:08:40"
},
"domain" : {
"id" : "",
"name" : ""
},
"preparation" : "1、确保网路联通\n2、安装Chrome浏览器\n3、准备测试账户,请从账户管理系统获取最新测试账号和密码",
"steps" : [ {
"test_step" : "在浏览器地址栏输入",
"expect_result" : "浏览器跳转”"
}, {
"test_step" : "输入测试账号",
"expect_result" : "账号输入框内显示输入的账号"
}, {
"test_step" : "输入测试账号密码",
"expect_result" : "密码输入框内显示与输入密码位数一致的“*”符号"
}, {
"test_step" : "单击“登录”按钮",
"expect_result" : "登录成功"
} ],
"module" : {
"id" : "",
"name" : ""
},
"issue" : {
"id" : "",
"name" : ""
},
"description" : "验证",
"label_list" : [ ],
"defect_list" : [ ],
"fixed_version" : {
"id" : "",
"name" : ""
}
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server Error |
错误码
请参见错误码。