文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务用例管理/ 根据任务批次id和用例uri查询用例结果（只能查询ticc等包含任务批次id的用例） - ShowTaskCaseResult
更新时间：2026-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

根据任务批次id和用例uri查询用例结果（只能查询ticc等包含任务批次id的用例） - ShowTaskCaseResult

功能介绍

根据任务批次id和用例uri查询用例结果（只能查询ticc等包含任务批次id的用例）

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/versions/{version_uri}/execute/results/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。

version_uri

是

String

版本URI

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

uri

否

String

参数解释

用例执行结果的唯一标识，用于查询指定的用例执行结果

约束限制

不涉及

取值范围

11-32位字母及数字

默认取值

不涉及

task_uri

否

String

参数解释

测试任务的唯一标识，用于筛选指定任务下的用例结果。获取方式请参见查询测试任务列表接口

约束限制

不涉及

取值范围

11-32位字母及数字

默认取值

不涉及

task_id

否

String

参数解释

执行任务的唯一标识，用于筛选指定执行的用例结果。获取方式请参见查询测试任务列表接口

约束限制

不涉及

取值范围

11-32位字母及数字

默认取值

不涉及

release_dev

否

String

参数解释

测试用例所属的版本号，用于按版本筛选用例结果

约束限制

允许：汉字、字母（a-z, A-Z）、数字（0-9）、下划线（_）、连字符（-）、点号（.）、破折号（—）

取值范围

3-32个字符

默认取值

不涉及

execute_id

否

String

参数解释

测试套当次执行id，同一个测试套每次执行的id唯一。可从查询测试任务执行结果接口获取

约束限制

字符串类型，长度11-32位字符

取值范围

11-32位字母及数字

默认取值

不涉及

case_uris

否

Array of strings

参数解释

测试套中用例的uri列表，数组中每个元素为用例URI，长度11~32位，由字母和数字组成

约束限制

不涉及

默认取值

不涉及

page_no

否

Integer

参数解释

当前页码

约束限制

大于0的整数

取值范围

大于0小于100

默认取值

不涉及

page_size

否

Integer

参数解释

每页条数

约束限制

大于0的整数

取值范围

大于0小于100

默认取值

不涉及

sort_field

否

String

参数解释

排序字段

约束限制

不涉及

取值范围

小于128位字符

默认取值

不涉及

sort_type

否

String

参数解释:

排序方式

约束限制:

不涉及

取值范围:

  • ASC：升序

  • DESC：降序

默认取值:

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

total

Integer

参数解释

总数

取值范围

不小于1的正整数

page_no

Integer

参数解释

当前页码

取值范围

大于0且小于100的正整数

page_size

Integer

参数解释

分页大小

取值范围

大于零且小于20000的正整数

value

Array of TestResultVo objects

参数解释

用例执行结果列表，数组内每个TestResultVo对象代表一次用例执行的结果记录

取值范围

不涉及
表4 TestResultVo

参数

参数类型

描述

uri

String

参数解释

用例执行结果的唯一标识URI

取值范围

11-34位字母及数字

name

String

参数解释

用例结果名称，用于标识本次用例执行的结果记录

取值范围

不涉及

author

String

参数解释

用例结果创建人的用户ID

取值范围

不涉及

rank

Integer

参数解释

用例的优先级级别

取值范围

  • 0：Priority 0

  • 1：Priority 1

  • 2：Priority 2

  • 3：Priority 3

  • 4：Priority 4

result

Integer

参数解释

测试结果Code，用于标识用例的执行结果

取值范围

不涉及

round

Integer

参数解释

用例执行的批次编号

取值范围

大于等于1的整数

preparation

String

参数解释

用例执行的前置条件

取值范围

不涉及

description

String

参数解释

用例结果描述

取值范围

不涉及

region

String

参数解释

用例结果所属的逻辑Region

取值范围

不涉及

steps

Array of ResultStepVo objects

参数解释

用例执行的步骤列表，每个步骤包含步骤内容、预期结果和实际结果，具体请参见ResultStepVo数据结构

取值范围

不涉及

number

String

参数解释

用例结果编号

取值范围

不涉及

author_name

String

参数解释

用例结果创建人的用户名称

取值范围

不涉及

begin_time

String

参数解释

用例执行的开始时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

begin_time_timestamp

Long

参数解释

执行开始时间的时间戳，单位为毫秒

取值范围

不涉及

end_time

String

参数解释

用例执行的结束时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

end_time_timestamp

Long

参数解释

执行结束时间的时间戳，单位为毫秒

取值范围

不涉及

creation_date

String

参数解释

用例结果创建时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

creation_date_timestamp

Long

参数解释

用例结果创建时间的时间戳，单位为毫秒

取值范围

不涉及

last_modified

String

参数解释

最后修改时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

last_modified_timestamp

Long

参数解释

最后修改时间的时间戳，单位为毫秒

取值范围

不涉及

last_change_time

String

参数解释

用例结果最后变更的时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

last_change_time_timestamp

Long

参数解释

最后变更时间的时间戳，单位为毫秒

取值范围

不涉及

dfx_test_result

String

参数解释

DFX测试结果

取值范围

不涉及

failure_cause

String

参数解释

用例执行失败的原因

取值范围

不涉及

parent_uri

String

参数解释

父节点的唯一标识，为分支用例URI或迭代用例URI，用于标识当前用例结果所属的父级用例

取值范围

不涉及

test_case_uri

String

参数解释

分支用例的唯一标识

取值范围

不涉及

test_case_name

String

参数解释

测试用例的名称

取值范围

不涉及

task_uri

String

参数解释

测试任务的唯一标识

取值范围

不涉及

result_name

String

参数解释

测试结果的中文名称，如通过、失败等

取值范围

不涉及

test_result_ae

String

参数解释

是否自动化执行

取值范围

  • '0'：非自动化执行

  • '1'：自动化执行

executor_id

String

参数解释

执行该用例的用户的唯一标识

取值范围

不涉及

executor_name

String

参数解释

执行该用例的用户名称

取值范围

不涉及

task_id

String

参数解释

执行机任务ID

取值范围

不涉及

execute_id

String

参数解释

执行ID

取值范围

不涉及

time_cost

Integer

参数解释

执行耗时，单位为毫秒

取值范围

不涉及

step_txt

String

参数解释

用例执行的测试步骤文本内容

取值范围

不涉及

step_expect

String

参数解释

测试步骤期望结果

取值范围

不涉及

step_actual

String

参数解释

测试步骤的实际执行结果描述

取值范围

不涉及

step_result

String

参数解释

测试步骤的执行结果状态

取值范围

不涉及

release_dev

String

参数解释

版本号

取值范围

不涉及

creation_version_uri

String

参数解释

创建版本URI

取值范围

不涉及

version_uri

String

参数解释

用例结果所属版本的唯一标识

取值范围

不涉及

project_uuid

String

参数解释

项目UUID，项目唯一标识

取值范围

固定长度32位字符（字母和数字）

report_url

String

参数解释

第三方过来的执行结果，返回跳转到第三方的url

取值范围

不涉及

test_case_number

String

参数解释

测试用例的编号，用于唯一标识用例

取值范围

不涉及

service_type

String

参数解释:

服务类型

取值范围:

  • -1：全量用例

  • 0：手工测试

  • 1：接口自动化

  • 7：功能自动化

  • 8：WebUI自动化

  • 100：自定义自动化(工厂)

  • 11：性能自动化
表5 ResultStepVo

参数

参数类型

描述

result

String

参数解释

测试步骤的执行结果状态码

取值范围

不涉及

test_step

String

参数解释

测试步骤的具体操作描述

取值范围

不涉及

expect_result

String

参数解释

测试步骤的预期执行结果

取值范围

不涉及

actual_result

String

参数解释

测试步骤的实际执行结果

取值范围

不涉及

result_name

String

参数解释

测试步骤执行结果的中文名称，如通过、失败等

取值范围

不涉及

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/a5eb0d410ea341a192f7c12483568985/versions/v90100010gpop318/execute/results/batch-query

{
  "execute_id" : "v90100010p0cret",
  "case_uris" : [ "v90100010p0cre5r" ]
}

响应示例

状态码：200

{
  "total" : 1,
  "value" : [ {
    "uri" : "v90600010s47t70n",
    "name" : "基线 Result2025-10-18",
    "author" : "TMSS002",
    "result" : 0,
    "round" : 0,
    "preparation" : "",
    "description" : "<p><br></p>",
    "region" : "roma-guian-2",
    "steps" : [ ],
    "begin_time" : "2025-10-18 10:48:34",
    "begin_time_timestamp" : 1760755714000,
    "end_time" : "2025-10-18 10:48:34",
    "end_time_timestamp" : 1760755714000,
    "creation_date" : "2025-10-18 10:48:34",
    "last_modified" : "2025-10-18 10:48:34",
    "last_modified_timestamp" : 1760755714000,
    "last_change_time" : "2025-10-18 10:48:34",
    "last_change_time_timestamp" : 1760755714000,
    "parent_uri" : "v90100010p0cre5r",
    "test_case_uri" : "v90100010p0cre5r",
    "test_case_name" : "样例功能用例",
    "task_uri" : "v90100010p0crets",
    "result_name" : "成功",
    "task_id" : "v90600010s2af75s",
    "execute_id" : "v90100010p0cret",
    "time_cost" : 0,
    "step_actual" : "",
    "step_result" : "",
    "creation_version_uri" : "v90100010p0crcjn",
    "version_uri" : "v90100010p0crcjn"
  } ],
  "page_size" : 20,
  "page_no" : 1
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档