# 查询该套件下，测试用例列表，用例基础信息 - ShowCasesByStid #### 功能介绍 根据测试套id查询该测试套件下用例详细信息 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v2/querycasesbystid 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | testServiceId | 是 | String | **参数解释** 项目唯一标识 **约束限制** 不涉及 **取值范围** 32个字符组成的字符串 **默认取值** 不涉及 **获取方法** 进入项目，地址栏获取testServiceId | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | ShowCasesByStidRequestBody | 是 | String | 查询测试套用例列表的请求信息 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [CommonResponseErrorOfobject] object | **参数解释** 统一错误返回 **取值范围** 不涉及 | | result | [QueryAllCasesPageResponse] object | **参数解释** 结果 **取值范围** 不涉及 | | status | String | **参数解释** 请求结果状态 **取值范围** - success, 查询计费信息成功 - error, 查询计费信息失败 3-128个字符组成的字符串 | 表5CommonResponseErrorOfobject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释** 接口调用失败错误码 **取值范围** 不超过256个字符组成的字符串 | | reason | String | **参数解释** 接口调用失败原因 **取值范围** 不超过1000个字符组成的字符串 | 表6QueryAllCasesPageResponse | 参数 | 参数类型 | 描述 | |:---|:---|:---| | casesArr | Array of objects | 测试套中的的测试用例列表 | | pageNo | Long | 分页起始下标 | | pageSize | Long | 分页大小 | | totalCount | Long | 用例总数量 | | totalPage | Long | 用例总页数 | **状态码：201** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [CommonResponseErrorOfobject] object | **参数解释** 统一错误返回 **取值范围** 不涉及 | | result | [QueryAllCasesPageResponse] object | **参数解释** 结果 **取值范围** 不涉及 | | status | String | **参数解释** 请求结果状态 **取值范围** - success, 查询计费信息成功 - error, 查询计费信息失败 3-128个字符组成的字符串 | 表8CommonResponseErrorOfobject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释** 接口调用失败错误码 **取值范围** 不超过256个字符组成的字符串 | | reason | String | **参数解释** 接口调用失败原因 **取值范围** 不超过1000个字符组成的字符串 | 表9QueryAllCasesPageResponse | 参数 | 参数类型 | 描述 | |:---|:---|:---| | casesArr | Array of objects | 测试套中的的测试用例列表 | | pageNo | Long | 分页起始下标 | | pageSize | Long | 分页大小 | | totalCount | Long | 用例总数量 | | totalPage | Long | 用例总页数 | **状态码：401** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | **状态码：403** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | **状态码：404** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。