查询需求下的用例列表 - ShowTestCasesByIssue
功能介绍
此接口用于查询指定需求下的用例列表,同页面测试-> 测试用例 -> 左侧树状图选择需求 -> 选中需求查询需求下的用例
调用方法
请参见如何调用API。
URI
POST /v4/{project_id}/issues/{issue_id}/testcases/batch-query
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID |
|
issue_id |
是 |
String |
需求id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
page_no |
否 |
Integer |
页码 |
|
page_size |
否 |
Integer |
每页数量 |
|
sort_field |
否 |
String |
排序字段 |
|
sort_type |
否 |
String |
参数解释: 排序方式 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
version_uri |
否 |
String |
版本uri |
|
relate_type |
否 |
String |
参数解释: 关联关系类型 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
|
key_word |
否 |
String |
关键字 |
|
rank_ids |
否 |
Array of strings |
用例等级ID集合 |
|
result_codes |
否 |
Array of strings |
结果Code集合 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
value |
QueryTestCasesByIssueVo object |
请求返回的数据 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
case_status_map |
Map<String,String> |
用例状态 |
|
new_create |
Integer |
新建态 |
|
designing |
Integer |
设计态 |
|
finished |
Integer |
完成态 |
|
testing |
Integer |
测试态 |
|
test_case_num |
Integer |
需求关联的用例数量 |
|
testcases |
Array of TestCaseVo objects |
用例详情 |
|
total_count |
Integer |
用例总数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
uri |
String |
参数解释 用例ID 取值范围 不涉及 |
|
number |
String |
参数解释 用例编号 取值范围 不涉及 |
|
name |
String |
参数解释 用例名称 取值范围 不涉及 |
|
rank |
String |
参数解释 用例等级 取值范围 不涉及 |
|
dr_relation_id |
String |
参数解释 工作项id 取值范围 不涉及 |
|
status_code |
String |
参数解释 状态ID 取值范围 不涉及 |
|
status_name |
String |
参数解释 状态名称 取值范围 不涉及 |
|
author |
String |
参数解释 创建人名称 取值范围 不涉及 |
|
author_id |
String |
参数解释 创建人ID 取值范围 不涉及 |
|
owner |
String |
参数解释 处理人名称 取值范围 不涉及 |
|
project_uuid |
String |
参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围 不涉及 |
|
test_type |
String |
参数解释: 测试类型 取值范围:
|
|
creation_date |
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 |
接口调用失败错误信息 |
请求示例
post https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/issues/1134703430181982208/testcases/batch-query
{
"page_no" : 1,
"page_size" : 100,
"relate_type" : "bug",
"sort_type" : "DESC"
}
响应示例
状态码：200
OK
{
"value" : {
"case_status_map" : {
"完成" : 1
},
"new_create" : 0,
"designing" : 0,
"finished" : 1,
"testing" : 0,
"test_case_num" : 1,
"testcases" : [ {
"uri" : "v90410b5o5ce22a7",
"type" : "TestCase",
"author" : "sec_admin——nich",
"name" : "cx_2995",
"rank" : 2,
"region" : "roma-dev-2-arm",
"owner" : "",
"version_uri" : "v90200010aelu5om",
"parent_uri" : "v90200010aelu5om",
"parent_path" : "/407ac57de7ea44d28e47293a2b9cf15c/v90200010aelu5om/",
"creation_version_uri" : "v90100010b5nubs0",
"last_modifier" : "sec_admin——nich",
"last_modified" : "2025-05-29 10:25:40",
"last_change_time" : "2025-03-21 18:25:43",
"creation_date" : "2025-03-21 18:25:04",
"author_id" : "2ce06fffb4634271a377c1cd7c429704",
"number" : "7417",
"case_type" : 0,
"platform_type" : 0,
"service_type" : 0,
"test_type" : 1,
"test_step" : "[\"\"]",
"expect_output" : "[\"\"]",
"auto_type" : 0,
"to_be_auto_exec" : 0,
"automatically_executed" : 0,
"is_contract_testcase" : 0,
"time_cost" : 0,
"last_exe_author" : "2ce06fffb4634271a377c1cd7c429704",
"status_code" : "7",
"result_code" : "1",
"execute_latest_time" : "2025-05-29 10:25:40",
"execute_duration" : "00:00:00.000",
"is_keyword" : 0,
"project_uuid" : "407ac57de7ea44d28e47293a2b9cf15c",
"issue_id" : "[\"1134703430181982208\"]",
"issue_tracker_id" : "[\"3\"]",
"issue_assign_status" : "[null]",
"issue_name" : "[\"史蒂文\"]",
"issue_design_owner" : "[null]",
"issue_design_owner_d" : "[null]",
"tracker_name" : "[\"Bug\"]",
"defect_list" : [ ],
"result_name" : "失败",
"status_name" : "完成"
} ],
"total_count" : 1
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server Error |
错误码
请参见错误码。
