查询该套件下，测试用例列表，用例基础信息
功能介绍
查询该套件下，测试用例列表，用例基础信息
调用方法
请参见如何调用API。
URI
POST /v2/querycasesbystid
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
testServiceId |
是 |
String |
项目唯一标识 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 字符串长度不少于1，不超过10万。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ShowCasesByStidRequestBody |
是 |
String |
查询测试套用例列表的请求信息 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
CommonResponseErrorOfobject object |
统一错误返回 |
|
result |
QueryAllCasesPageResponse object |
结果 |
|
status |
String |
状态值，如success、error |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
casesArr |
Array of objects |
测试套中的的测试用例列表 |
|
pageNo |
Long |
分页起始下标 |
|
pageSize |
Long |
分页大小 |
|
totalCount |
Long |
用例总数量 |
|
totalPage |
Long |
用例总页数 |
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
CommonResponseErrorOfobject object |
统一错误返回 |
|
result |
QueryAllCasesPageResponse object |
结果 |
|
status |
String |
状态值，如success、error |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
casesArr |
Array of objects |
测试套中的的测试用例列表 |
|
pageNo |
Long |
分页起始下标 |
|
pageSize |
Long |
分页大小 |
|
totalCount |
Long |
用例总数量 |
|
totalPage |
Long |
用例总页数 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 |
|
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 |
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 |
|
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 12-18个字符组成的字符串 |
|
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 3-1000个字符组成的字符串 |
请求示例
post https://{endpoint}/v2/querycasesbystid?testServiceId=a4e2ec2a6d4c485680b144386c6b2806
"{
"suiteid": "v92s00010i8103d1",
"sortField": "",
"sortType": "",
"status": [],
"ownerIds": [],
"results": [],
"planId": "",
"stage": null,
"pageNo": 1,
"pageSize": 5
}"
响应示例
状态码：200
根据测试套唯一标识查询所有用例数据成功
{
"status" : "success",
"result" : {
"pageNo" : 1,
"pageSize" : 5,
"totalCount" : 2,
"totalPage" : 1,
"casesArr" : [ {
"baseInfo" : {
"id" : "v92s00010i8103d6",
"owner" : null,
"ownerId" : "",
"projectUUId" : "3edb3bb58bcb4ef6aca3fa8377e75788",
"caseName" : "TC_wp50JryP",
"caseNumber" : "101",
"status" : "0",
"statusName" : "新建",
"result" : "-1",
"resultName" : "未执行",
"caseId" : "v92s00010i81017n",
"testSuiteId" : "v92s00010i8103d1",
"latestTime" : null,
"updateTime" : "2025-06-17 15:27:48",
"executeDuration" : null,
"updator" : "CloudTest-0704",
"updatorId" : "fdc93bccd8d040778701d4d35a4a4313",
"isForbidden" : 1,
"isKeyWord" : 0,
"scriptUrl" : "ApiTest/API接口测试项目_B84uOR_alpha/src/scripts/user/Case_23a8ccb5af8245388e28066d4ae7591d_2.java",
"netWorkScriptName" : "",
"stage" : 1
},
"latestTime" : "",
"executeDuration" : "",
"status" : "",
"result" : ""
}, {
"baseInfo" : {
"id" : "v92s10i8103d6ioi",
"owner" : null,
"ownerId" : "",
"projectUUId" : "3edb3bb58bcb4ef6aca3fa8377e75788",
"caseName" : "TC_cHRk1aTt",
"caseNumber" : "102",
"status" : "0",
"statusName" : "新建",
"result" : "-1",
"resultName" : "未执行",
"caseId" : "v92u00010i8102ca",
"testSuiteId" : "v92s00010i8103d1",
"latestTime" : null,
"updateTime" : "2025-06-17 15:27:48",
"executeDuration" : null,
"updator" : "CloudTest-0704",
"updatorId" : "fdc93bccd8d040778701d4d35a4a4313",
"isForbidden" : 1,
"isKeyWord" : 0,
"scriptUrl" : "ApiTest/API接口测试项目_B84uOR_alpha/src/scripts/user/Case_2faf4824838e4d58a10f709720923e48_2.java",
"netWorkScriptName" : "",
"stage" : 1
},
"latestTime" : "",
"executeDuration" : "",
"status" : "",
"result" : ""
} ]
},
"error" : null
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
根据测试套唯一标识查询所有用例数据成功 |
|
201 |
Created |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
错误码
请参见错误码。
