获取用例历史执行数据 - ListDebugCases

功能介绍

根据查询参数获取用例历史执行数据

调用方法

请参见如何调用API。

URI

POST /v2/casehistory

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

请求参数

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

表3 请求Body参数
参数	是否必选	参数类型	描述
ListDebugCasesRequestBody	是	String	查询获取用例历史执行数据请求体

响应参数

状态码：200

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

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

表6 QueryCasesResponseV2
参数	参数类型	描述
caseResultList	Array of CaseHistoryResult objects	历史结果列表
pageNo	Integer	分页起始下标
totalCount	Integer	用例总数量
totalPage	Integer	用例总页数

表7 CaseHistoryResult
参数	参数类型	描述
author	String	处理人
authorid	String	处理人唯一标识
caseName	String	用例名称
endTime	String	结束时间
failureCause	String	失败原因
id	String	主键ID
log	String	日志
num	Integer	顺序
number	String	用例唯一标识
planId	String	计划唯一标识
releaseversion	String	版本号
result	String	结果
startTime	String	开始时间
status	String	状态
taskId	String	任务唯一标识
taskName	String	任务名称
testServiceId	String	工程唯一标识

状态码：201

表8 响应Body参数
参数	参数类型	描述
error	CommonResponseErrorOfobject object	统一错误返回
result	QueryCasesResponseV2 object	结果
status	String	状态值，如success、error

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

**表10** QueryCasesResponseV2
参数	参数类型	描述
caseResultList	Array of CaseHistoryResult objects	历史结果列表
pageNo	Integer	分页起始下标
totalCount	Integer	用例总数量
totalPage	Integer	用例总页数

**表11** CaseHistoryResult
参数	参数类型	描述
author	String	处理人
authorid	String	处理人唯一标识
caseName	String	用例名称
endTime	String	结束时间
failureCause	String	失败原因
id	String	主键ID
log	String	日志
num	Integer	顺序
number	String	用例唯一标识
planId	String	计划唯一标识
releaseversion	String	版本号
result	String	结果
startTime	String	开始时间
status	String	状态
taskId	String	任务唯一标识
taskName	String	任务名称
testServiceId	String	工程唯一标识

状态码：401

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

状态码：403

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

状态码：404

**表14** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

请求示例

post https://{endpoint}/v2/casehistory?testServiceId=afd8fc0bc3d74f5f9a99a46321b8e20b

"{
  "caseId": "v92t00010i80vhsp",
  "testServiceId": "afd8fc0bc3d74f5f9a99a46321b8e20b",
  "pageNum": 1,
  "pageSize": 5
}"

响应示例

状态码：200

根据测试套唯一标识查询所有用例数据成功

{
  "status" : "success",
  "result" : {
    "totalCount" : 1,
    "totalPage" : 1,
    "pageNo" : 1,
    "caseResultList" : [ {
      "taskId" : "df19c643fc38441c90de90578c2c33a3",
      "testServiceId" : "afd8fc0bc3d74f5f9a99a46321b8e20b",
      "taskName" : "taskTestSuite2022/8/23 11:33:40",
      "number" : "v92t00010i80vhsp",
      "caseName" : "TC_igd4AmSX",
      "startTime" : "2025-06-17 15:27:31 957",
      "author" : "CloudTest-0704",
      "endTime" : null,
      "result" : "5",
      "status" : "Running",
      "log" : "00:00:00.405",
      "failureCause" : null,
      "num" : 1,
      "id" : "0f6749c7-43f2-4e7c-a4c5-55d0c884102b",
      "releaseversion" : null,
      "authorid" : "fdc93bccd8d040778701d4d35a4a4313",
      "planId" : ""
    } ]
  },
  "error" : null
}