根据条件分页获取测试用例对象
功能介绍
根据条件分页获取测试用例对象
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/testcases/page
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目的32位uuid,项目唯一标识,通过获取CodeArts项目ID接口查询项目列表获取。 取值范围: 字符串长度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 |
参数解释: 错误码 取值范围: 大小写字母、数字。 长度限制0到20位 |
data |
BasePageInfoTestCase object |
参数解释: 返回体 取值范围: 不涉及 |
message |
String |
参数解释: 错误信息 取值范围: 大小写字母、数字、符号、中文。 长度限制0到1000位 |
参数 |
参数类型 |
描述 |
---|---|---|
limit |
Integer |
参数解释: 每页显示的条目数量,最大支持200条 取值范围: 数字,范围1到200。 |
list |
Array of TestCase objects |
参数解释: 返回体 取值范围: 不涉及 |
offset |
Integer |
参数解释: 起始偏移量,表示从此偏移量开始查询,offset大于等于0,小于等于100000 取值范围: 数字,范围0-100000。 |
pages |
Integer |
参数解释: 总页数量 取值范围: 数字,范围1-100。 |
size |
Integer |
参数解释: 列表个数 取值范围: 数字,范围1-200。 |
total |
Long |
参数解释: 总数 取值范围: 数字。 |
参数 |
参数类型 |
描述 |
---|---|---|
auto_type |
String |
参数解释: 自动化类型 取值范围: 大小写字母、数字、符号。 |
case_design_desc |
String |
参数解释: 用例设计描述 取值范围: 大小写字母、数字、符号、中文。 |
case_name |
String |
参数解释: 用例名称 取值范围: 大小写字母、数字、符号、中文。 长度限制1-10000位 |
case_num |
String |
参数解释: 用例编号 取值范围: 大小写字母、数字、符号。 |
create_time |
String |
参数解释: 创建时间 取值范围: 固定日期格式yyyy-MM-dd HH:mm:ss |
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 主键 取值范围: 大小写字母、数字。 长度限制固定32位 |
is_archive |
Boolean |
参数解释: 是否归档 取值范围:
|
mindmap_id |
String |
参数解释: 脑图ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
node_id |
String |
参数解释: 节点ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
batch_id |
String |
参数解释: 批次id 取值范围: 大小写字母、数字。 长度限制固定32位 |
branch_id |
String |
参数解释: 分支ID 取值范围: 大小写字母、数字。 |
plan_id |
String |
参数解释: 计划ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
prerequisite |
String |
参数解释: 用例前置步骤 取值范围: 大小写字母、数字、符号、中文。 |
test_case_level |
String |
参数解释: 测试用例级别 取值范围: 大小写字母、数字、符号、中文。 |
test_procedure |
String |
参数解释: 测试步骤 取值范围: 大小写字母、数字、符号、中文。 |
update_name |
String |
参数解释: 更新人名字 取值范围: 大小写字母、数字、符号、中文。 |
update_num |
String |
参数解释: 更新人工号 取值范围: 大小写字母、数字。 |
update_time |
String |
参数解释: 更新时间 取值范围: 固定日期格式yyyy-MM-dd HH:mm:ss |
url |
String |
参数解释: url |
uri |
String |
参数解释: uri 取值范围: 大小写字母、数字、符号。 |
project_id |
String |
参数解释: 项目ID 取值范围: 大小写字母、数字。 长度限制固定32位 |
service_id |
String |
参数解释: 服务id 取值范围: 大小写字母、数字。 长度限制固定32位 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释: 接口调用错误码。 取值范围: 大小写字母、数字。 长度限制0到20位 |
data |
String |
参数解释: 接口调用返回体 取值范围: 不涉及 |
message |
String |
参数解释: 接口调用错误信息 取值范围: 大小写字母、数字、符号、中文。 长度限制0到1000位 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释: 接口调用错误码。 取值范围: 大小写字母、数字。 长度限制0到20位 |
data |
String |
参数解释: 接口调用返回体 取值范围: 不涉及 |
message |
String |
参数解释: 接口调用错误信息 取值范围: 大小写字母、数字、符号、中文。 长度限制0到1000位 |
请求示例
根据条件分页获取测试用例对象
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 |
错误码
请参见错误码。