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

功能介绍

查询用例下的需求/缺陷

调用方法

请参见如何调用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	处理者列表中是否包含空
severityContainEmpty	否	Boolean	重要程度列表中是否包含空
statusContainEmpty	否	Boolean	状态列表中是否包含空

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
value	Array of RelationVo objects	请求返回的数据
total	Integer	总数
page_no	Integer	第几页
page_size	Integer	每页条数

表3 RelationVo
参数	参数类型	描述
dr_number	String	需求id
test_case_uri	String	用例uri
relate_type	String	资源类型
resource_type	String	资源类型
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参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：401

表5 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：404

表6 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：500

表7 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

请求示例

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

{
  "project_uuid" : "9c115c0e26ee492386cfa408f7e8ed92",
  "version_uri" : "v90200010ovl7ss9",
  "page_no" : 1,
  "page_size" : 10,
  "test_case_uris" : [ "v90510sa530ad5pe" ]
}

响应示例

状态码：200

{
  "total" : 1,
  "value" : [ {
    "resource_type" : "TestCase",
    "issue_id" : "1186322840050868225",
    "title" : "1",
    "owner" : "昵称aaa",
    "tracker_id" : "7",
    "tracker_name" : "IR",
    "status" : "初始",
    "status_id" : "13",
    "sequence_id" : "IR20251018975242",
    "dts" : [ ],
    "bug" : [ ]
  } ],
  "page_size" : 10,
  "page_no" : 1
}