文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 获取测试套关联用例详情
更新时间：2026-06-03 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取测试套关联用例详情

功能介绍

此接口用于查询测试套下已关联的用例,同页面 测试 -> 测试执行 -> 点击测试套详情 -> 显示关联的用例。

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/tasks/{task_uri}/testcases/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

task_uri

是

String

任务uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

value

否

Array of TaskAssignCaseDetailVo objects

获取测试套关联用例详情返回参数
表3 TaskAssignCaseDetailVo

参数

是否必选

参数类型

描述

uri

否

String

关联关系uri

sort

否

Integer

排序顺序

owner

否

String

责任人id

stage

否

Integer

测试阶段

project_id

否

String

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

task_uri

否

String

任务uri

update_time

否

String

测试套关联用例的更新时间

updator_name

否

String

测试套关联用例的更新人

updator

否

String

测试套关联用例的更新人id

result_execute_time

否

String

结果的最后修改时间

result_executor_name

否

String

结果的最后修改人名称

result_executor_id

否

String

结果的最后修改人id

case_uri

否

String

用例uri

is_available

否

Integer

是否可用

test_case_name

否

String

用例名称

feature_uri

否

String

用例目录Uri

test_case_number

否

String

用例编号

svn_script_path

否

String

脚本路径

status_code

否

String

状态

status_name

否

String

状态名称

result_code

否

String

结果id

result_name

否

String

结果名称

owner_name

否

String

责任人名称

execute_latest_time

否

String

最新执行时间

execute_duration

否

String

执行时长

is_keyword

否

Integer

是否是关键用例

net_work_script_name

否

String

脚本名称

rank_id

否

Integer

用例等级

remark

否

String

描述

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

value

Array of TaskAssignCaseDetailVo objects

获取测试套关联用例详情返回参数
表5 TaskAssignCaseDetailVo

参数

参数类型

描述

uri

String

关联关系uri

sort

Integer

排序顺序

owner

String

责任人id

stage

Integer

测试阶段

project_id

String

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

task_uri

String

任务uri

update_time

String

测试套关联用例的更新时间

updator_name

String

测试套关联用例的更新人

updator

String

测试套关联用例的更新人id

result_execute_time

String

结果的最后修改时间

result_executor_name

String

结果的最后修改人名称

result_executor_id

String

结果的最后修改人id

case_uri

String

用例uri

is_available

Integer

是否可用

test_case_name

String

用例名称

feature_uri

String

用例目录Uri

test_case_number

String

用例编号

svn_script_path

String

脚本路径

status_code

String

状态

status_name

String

状态名称

result_code

String

结果id

result_name

String

结果名称

owner_name

String

责任人名称

execute_latest_time

String

最新执行时间

execute_duration

String

执行时长

is_keyword

Integer

是否是关键用例

net_work_script_name

String

脚本名称

rank_id

Integer

用例等级

remark

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/projects/f3087a82b44744c29a1bd69ab6ada154/tasks/v90100010gmi4h0j/testcases/batch-query

{
  "page_no" : 1,
  "page_size" : 15,
  "results" : [ ],
  "status" : [ ],
  "version_uri" : "v90200010aelu5om",
  "owners" : [ ],
  "rank_ids" : [ ]
}

响应示例

状态码：200

OK

{
  "value" : [ {
    "uri" : "v90100010gmi4sgs",
    "sort" : 1,
    "owner" : "",
    "stage" : 1,
    "project_id" : "407ac57de7ea44d28e47293a2b9cf15c",
    "task_uri" : "v90100010gmi4h0j",
    "update_time" : "2025-05-29 10:25:40",
    "updator_name" : "sec_admin——nich",
    "updator" : "2ce06fffb4634271a377c1cd7c429704",
    "case_uri" : "v90410b5o5ce22a7",
    "is_available" : 1,
    "test_case_name" : "cx_2995",
    "test_case_number" : "7417",
    "status_code" : "7",
    "status_name" : "完成",
    "result_code" : "1",
    "result_name" : "失败",
    "is_keyword" : 0,
    "rank_id" : 2
  }, {
    "uri" : "v90110gmi4sgsf2e",
    "sort" : 2,
    "owner" : "",
    "stage" : 1,
    "project_id" : "407ac57de7ea44d28e47293a2b9cf15c",
    "task_uri" : "v90100010gmi4h0j",
    "update_time" : "2025-05-29 10:25:39",
    "updator_name" : "sec_admin——nich",
    "updator" : "2ce06fffb4634271a377c1cd7c429704",
    "case_uri" : "v90200010gmhoo73",
    "is_available" : 1,
    "test_case_name" : "sdw",
    "test_case_number" : "7421",
    "status_code" : "0",
    "status_name" : "新建",
    "result_name" : "未执行",
    "is_keyword" : 0,
    "rank_id" : 2
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试套管理