查询该套件下，测试用例列表，用例基础信息 - ShowCasesByStid

功能介绍

根据测试套id查询该测试套件下用例详细信息

调用方法

URI

POST /v2/querycasesbystid

表1 Query参数
参数	是否必选	参数类型	描述
testServiceId	是	String	项目唯一标识

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：必传。取值范围：字符串长度不少于1，不超过10万。默认取值：不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
ShowCasesByStidRequestBody	是	String	查询测试套用例列表的请求信息

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
error	CommonResponseErrorOfobject object	统一错误返回
result	QueryAllCasesPageResponse object	结果
status	String	状态值，如success、error success,请求成功 error,请求报错

表5 CommonResponseErrorOfobject
参数	参数类型	描述
code	String	错误码
reason	String	错误原因

表6 QueryAllCasesPageResponse
参数	参数类型	描述
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 success,请求成功 error,请求报错

表8 CommonResponseErrorOfobject
参数	参数类型	描述
code	String	错误码
reason	String	错误原因

表9 QueryAllCasesPageResponse
参数	参数类型	描述
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
}