文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 用例关联关系管理/ 查询用例下的需求/缺陷 - GetRelationsByTestCases
更新时间：2026-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询用例下的需求/缺陷 - GetRelationsByTestCases

功能介绍

此接口用于查询用例下的需求/缺陷 测试 -> 测试用例 -> 用例详情 -> 需求列表/缺陷列表

调用方法

请参见如何调用API。

URI

POST /v4/testcases/relations/batch-query

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

project_uuid

是

String

参数解释

项目UUID

约束限制

不涉及

取值范围

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

默认取值

获取方式请参见获取项目ID

version_uri

否

String

参数解释

版本URI

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

tracker_id

否

String

参数解释

工作项类型ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

page_no

否

Integer

参数解释

页码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

page_size

否

Integer

参数解释

每页数量

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

relate_type

否

String

参数解释:

工作项类型

约束限制:

不涉及

取值范围:

  • bug，缺陷。

  • requirement，需求。

默认取值:

不涉及

test_case_uris

是

Array of strings

参数解释

用例URI列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

owner

否

Array of strings

参数解释

处理者列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

severity

否

Array of strings

参数解释

重要程度列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

status

否

Array of strings

参数解释

状态列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

findReleaseDev

否

Array of strings

参数解释

发现版本号列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

keyWord

否

String

参数解释

关键字

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

ownerContainEmpty

否

Boolean

参数解释

处理者列表中是否包含空

约束限制

不涉及

取值范围

  • true，包含。

  • false，不包含。

默认取值

不涉及

severityContainEmpty

否

Boolean

参数解释

重要程度列表中是否包含空

约束限制

不涉及

取值范围

  • true，包含。

  • false，不包含。

默认取值

不涉及

statusContainEmpty

否

Boolean

参数解释

状态列表中是否包含空

约束限制

不涉及

取值范围

  • true，包含。

  • false，不包含。

默认取值

不涉及

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

value

Array of RelationVo objects

参数解释

查询到的关联关系列表

取值范围

不涉及

page_size

Integer

每页展示条数

page_no

Integer

页码

has_more

String

是否有更多

total

String

符合条件的所有记录数

reason

String

错误信息
表3 RelationVo

参数

参数类型

描述

dr_number

String

参数解释

需求id

取值范围

不涉及

test_case_uri

String

参数解释

用例uri

取值范围

11-34位字母和数字

relate_type

String

参数解释

关联类型

取值范围

  • bug，缺陷。

  • requirement，需求。

resource_type

String

参数解释

资源类型

取值范围

  • testcase，用例。

  • testitem，目录。

source_system

String

参数解释

来源系统

取值范围

不涉及

association_number

String

参数解释

关联资源编号

取值范围

不涉及

region

String

参数解释

逻辑region

取值范围

外部使用公有云实际区域，内部使用默认值

issue_id

String

参数解释

工作项id

取值范围

不涉及

title

String

参数解释

标题

取值范围

不涉及

owner

String

参数解释

责任人

取值范围

不涉及

tracker_id

String

参数解释

工作项类型id

取值范围

不涉及

tracker_name

String

参数解释

工作项类型名称

取值范围

不涉及

severity

String

参数解释

重要程度

取值范围

不涉及

severity_id

String

参数解释

重要程度id

取值范围

不涉及

status

String

参数解释

状态

取值范围

不涉及

status_id

String

参数解释

状态id

取值范围

不涉及

board_name

String

参数解释

看板名称

取值范围

不涉及

board_id

String

参数解释

看板id

取值范围

不涉及

release_dev

String

参数解释

迭代id

取值范围

不涉及

sequence_id

String

参数解释

xBoard项目工作项序列号

取值范围

不涉及

dts

String

参数解释

dts系统缺陷

取值范围

不涉及

bug

String

参数解释

vision系统缺陷

取值范围

不涉及

total

Integer

参数解释

缺陷总数

取值范围

不涉及

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/testcases/relations/batch-query

{
  "project_uuid": "407ac57de7ea44d28e47293a2b9cf15c",
  "version_uri": "v90200010aelu5om",
  "test_case_uris":[
    "v92n11cseom8n7u6",
  ],
  "page_no":1,
  "page_size":10,
  "tracker_id":"",
  "relate_type":"requirement"
}

响应示例

状态码：200

{
  "total" : 0,
  "value" : [ ],
  "page_size" : 10,
  "page_no" : 1
}

状态码

状态码

描述

200

ok

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档