文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 用例关联关系管理/ 查询用例下的需求/缺陷 - GetRelationsByTestCases
更新时间：2026-07-28 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

参数解释 关键字 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及

响应参数

状态码：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 取值范围 不涉及

priority_name

String

参数解释 优先级 取值范围 不涉及

priority_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

Array of strings

参数解释 dts系统缺陷 取值范围 不涉及

bug

Array of strings

参数解释 vision系统缺陷 取值范围 不涉及

total

Integer

参数解释 缺陷总数 取值范围 不涉及

confidentiality_code

String

参数解释 资源密级等级编码，只有在涉密开关打开时，且资源设置了密级等级，才会返回 取值范围 不涉及

状态码：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

ok

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

状态码

状态码

描述

200

ok

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档