根据条件分页获取测试用例对象
功能介绍
根据条件分页获取测试用例对象
URI
POST /v2/{project_id}/testcases/page
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释： 项目的32位uuid，项目唯一标识，通过查询项目列表接口查询项目列表获取。 取值范围： 字符串长度32。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
params |
是 |
TestCasePageParam object |
用例分页参数 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
参数解释： 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 |
|
limit |
否 |
Integer |
参数解释： 每页显示的条目数量，最大支持200条 |
|
deleted |
否 |
String |
参数解释： 是否删除 取值范围：
|
|
id_collection |
否 |
Array of strings |
ID集合 |
|
mindmap_id |
否 |
String |
参数解释： 脑图ID 取值范围： 大小写字母、数字。 长度限制固定32位 |
|
node_id |
否 |
String |
参数解释： 节点ID 取值范围： 大小写字母、数字。 长度限制固定32位 |
|
node_id_collection |
否 |
Array of strings |
节点ID集合 |
|
project_id |
否 |
String |
参数解释： 项目ID 取值范围： 大小写字母、数字。 长度限制固定32位 |
|
is_archive |
否 |
Boolean |
参数解释： 是否归档 取值范围：
|
|
case_name |
否 |
String |
参数解释： 用例名称 取值范围： 大小写字母、数字、符号、中文。 长度限制1-10000位 |
|
has_sub_mindmap |
否 |
Boolean |
参数解释： 是否有子脑图 取值范围：
|
|
sub_mindmap_id |
否 |
Array of strings |
子脑图ID列表 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释： 错误码 |
|
data |
BasePageInfoTestCase object |
返回体 |
|
message |
String |
参数解释： 错误信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
limit |
Integer |
参数解释： 每页显示的条目数量，最大支持200条 |
|
list |
Array of TestCase objects |
返回体 |
|
offset |
Integer |
参数解释： 起始偏移量，表示从此偏移量开始查询，offset大于等于0，小于等于100000 |
|
pages |
Integer |
参数解释： 总页数量 |
|
size |
Integer |
参数解释： 列表个数 |
|
total |
Long |
总数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
auto_type |
String |
自动化类型 |
|
case_design_desc |
String |
用例设计描述 |
|
case_name |
String |
参数解释： 用例名称 取值范围： 大小写字母、数字、符号、中文。 长度限制1-10000位 |
|
case_num |
String |
用例编号 |
|
create_time |
String |
参数解释： 创建时间 |
|
creator_name |
String |
创建人名字 |
|
creator_num |
String |
参数解释： 创建者，用户在IAM中的ID。 取值范围： 大小写字母、数字。 长度限制固定32位 |
|
deleted |
String |
删除状态 |
|
expected_results |
String |
预期结果 |
|
extra_param |
String |
额外模板字段：以json形式存储，前台解析 |
|
factor_combination_json |
String |
因子组合json |
|
operation_and_expected_result |
String |
操作及预期结果 |
|
id |
String |
id 主键 |
|
is_archive |
Boolean |
参数解释： 是否归档 取值范围：
|
|
mindmap_id |
String |
参数解释： 脑图ID 取值范围： 大小写字母、数字。 长度限制固定32位 |
|
node_id |
String |
参数解释： 节点ID 取值范围： 大小写字母、数字。 长度限制固定32位 |
|
batch_id |
String |
批次id |
|
branch_id |
String |
分支ID |
|
plan_id |
String |
计划ID |
|
prerequisite |
String |
用例前置步骤 |
|
test_case_level |
String |
测试用例级别 |
|
test_procedure |
String |
测试步骤 |
|
update_name |
String |
更新人名字 |
|
update_num |
String |
更新人工号 |
|
update_time |
String |
参数解释： 更新时间 |
|
url |
String |
url |
|
uri |
String |
uri |
|
project_id |
String |
参数解释： 项目ID 取值范围： 大小写字母、数字。 长度限制固定32位 |
|
service_id |
String |
服务id |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释： 接口调用错误码 |
|
data |
String |
接口调用返回体 |
|
message |
String |
参数解释： 接口调用错误信息 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释： 接口调用错误码 |
|
data |
String |
接口调用返回体 |
|
message |
String |
参数解释： 接口调用错误信息 |
请求示例
根据条件分页获取测试用例对象
post https://{endpoint}/v2/b94c9a6947a44597891e0a7362e7383f/testcases/page
{
"params" : {
"mindmap_id" : "ba2725c5b72c4ec18214736ceb99f3d7",
"offset" : 1,
"limit" : 10
}
}响应示例
状态码：200
OK
{
"code" : "success",
"data" : {
"total" : 1,
"list" : [ {
"id" : "F0963D239A4E49219860EDC0741D7122",
"prerequisite" : "",
"url" : null,
"uri" : "",
"deleted" : "no",
"create_time" : "2025/01/10 11:00:45 GMT+08:00",
"creator_name" : "昵称xxx1111144445454545",
"creator_num" : "efdb403066474ab08836b9eeaaa23bca",
"update_name" : "昵称xxx1111144445454545",
"update_num" : "efdb403066474ab08836b9eeaaa23bca",
"update_time" : "2025/01/10 11:00:45 GMT+08:00",
"case_name" : "子主题",
"test_procedure" : "",
"expected_results" : "",
"operation_and_expected_result" : null,
"case_design_desc" : null,
"case_num" : null,
"auto_type" : "true",
"test_case_level" : "2",
"node_id" : "7B3E87D771504220A2B9C757E6AC42E1",
"mindmap_id" : "fb6bd82a6c084fdab0d8e5d8f820eabc",
"is_archive" : false,
"extra_param" : "{\"tcStatus\":\"init\"}",
"project_id" : "76667cb543a14cacac2ade913ca44a47",
"factor_combination_json" : null,
"batch_id" : null,
"service_id" : null,
"branch_id" : null,
"plan_id" : null
} ],
"offset" : 1,
"limit" : 10,
"pages" : 1,
"size" : 1
},
"message" : null
}状态码：400
Bad Request
{
"error_code" : "TESTMIND.00021882",
"error_msg" : "分支、计划id长度不合法，请稍后重试"
}状态码：401
Unauthorized
{
"error_code" : "DEV.00000003",
"error_msg" : "认证信息过期"
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
错误码
请参见错误码。
