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

参数解释

查询到的关联关系列表

取值范围

不涉及
表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

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

状态码

状态码

描述

200

ok

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档