查询迭代关联的需求列表(树结构) - ShowIssueTreePageByRoot

功能介绍

查询迭代关联的需求列表(树结构)

调用方法

URI

POST /v4/{project_id}/iterators/{iterator_uri}/issues/query-tree

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
iterator_uri	是	String	迭代uri

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
owner	否	String	参数解释过滤条件：处理人约束限制不涉及取值范围不涉及默认取值不涉及
issue_id	否	String	参数解释需求ID 约束限制不涉及取值范围不涉及默认取值不涉及
page_no	是	Integer	参数解释页码约束限制不涉及取值范围不涉及默认取值不涉及
page_size	是	Integer	参数解释每页展示条数约束限制不涉及取值范围不涉及默认取值不涉及
key_word	否	String	参数解释关键字约束限制不涉及取值范围不涉及默认取值不涉及
iteration_id	否	String	参数解释过滤条件：迭代ID 约束限制不涉及取值范围不涉及默认取值不涉及
severity_id	否	String	参数解释过滤条件：重要程度ID 约束限制不涉及取值范围不涉及默认取值不涉及
status_id	否	String	参数解释过滤条件：状态ID 约束限制不涉及取值范围不涉及默认取值不涉及
module_id	否	String	参数解释过滤条件：模块ID 约束限制不涉及取值范围不涉及默认取值不涉及
status_ids	否	String	参数解释过滤条件：状态ID多个条件，每个条件取或，约束限制不涉及取值范围 -2代表搜索未设置默认取值不涉及
module_ids	否	String	参数解释过滤条件：模块ID多个，每个条件取或约束限制不涉及取值范围 -2代表搜索未设置默认取值不涉及
pi_filter	否	Array of IssueListPiFilterInfo objects	参数解释迭代、pi过滤条件约束限制不涉及取值范围不涉及默认取值不涉及
status_names	否	Array of strings	参数解释状态名称列表约束限制不涉及取值范围不涉及默认取值不涉及
security_level_policy	否	Boolean	参数解释是否过滤用户不可见的高密数据约束限制不涉及取值范围 true\|\|false 默认取值 true

表3 IssueListPiFilterInfo
参数	是否必选	参数类型	描述
sprints	否	Array of strings	参数解释迭代列表约束限制不涉及取值范围不涉及默认取值不涉及
pi_id	否	String	参数解释 pi的id 约束限制不涉及取值范围层级关系：pi -> 迭代 -> 需求默认取值

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
value	Array of WorkItemVo objects	请求返回的数据
total	Integer	数据总数
page_no	Integer	页码
page_size	Integer	每页数据行数

表5 WorkItemVo
参数	参数类型	描述
name	String	参数解释工作项名称取值范围不涉及
owner	String	参数解释处理人取值范围不涉及
path	String	参数解释工作项路径取值范围不涉及
start_date	String	参数解释预计开始日期取值范围不涉及
due_date	String	参数解释预计结束日期取值范围不涉及
region	String	参数解释逻辑region 取值范围使用公有云实际区域
creator	String	参数解释创建人取值范围不涉及
updator	String	参数解释更新人取值范围不涉及
project_uuid	String	参数解释项目UUID 取值范围项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
work_item_id	String	参数解释工作项编号取值范围不涉及
status_id	String	参数解释状态ID 取值范围不涉及
status_name	String	参数解释状态取值范围不涉及
tracker_id	String	参数解释类型ID 取值范围不涉及
tracker_name	String	参数解释类型取值范围不涉及
iteration_id	String	参数解释迭代ID 取值范围不涉及
module_id	String	参数解释模块ID 取值范围不涉及
severity_id	String	参数解释重要程度ID 取值范围不涉及
severity_name	String	参数解释重要程度取值范围不涉及
parent_workitem_id	String	参数解释父工作项编号取值范围不涉及
board_id	String	参数解释看板ID 取值范围不涉及
board_name	String	参数解释看板名称取值范围不涉及
create_time	String	参数解释创建时间取值范围不涉及
update_time	String	参数解释更新时间取值范围不涉及
iteration_name	String	参数解释迭代名取值范围不涉及
module_name	String	参数解释模块名取值范围不涉及
module_path	String	参数解释模块path 取值范围不涉及
module_path_name	String	参数解释模块路径名称取值范围不涉及
owner_name	String	参数解释处理人取值范围不涉及
have_child_dynamic	Boolean	参数解释父工作项下是否有子工作项包含动态取值范围 true:是 false:否
has_child	Boolean	参数解释父工作项下是否有子工作项取值范围 true:有子工作项 false:无子工作项
issue_dynamic_count	Integer	参数解释需求动态数量取值范围不涉及
case_count	Integer	参数解释用例数量取值范围不涉及
sequence_id	String	参数解释 xBoard项目工作项序列取值范围不涉及号
pi_id	String	参数解释 pi的id 取值范围层级关系：pi -> 迭代 -> 需求
pi_name	String	参数解释迭代ID 取值范围不涉及

状态码：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/2e8b14eb90d54b6c9bc4c0b5cde1f449/iterators/2e8b14eb90/issues/query-tree

{
  "owner" : "e8ad9e7478c94f4eaf90d5a379af9cb1",
  "issue_id" : "efdb403066474ab08836b9eeaaa23bca",
  "page_no" : 1,
  "page_size" : 100,
  "key_word" : "管理",
  "iteration_id" : "10415967",
  "severity_id" : "12",
  "status_id" : "1",
  "module_id" : "261469",
  "status_ids" : "1",
  "module_ids" : "261469",
  "status_names" : [ "string" ]
}

响应示例

状态码：200

{
  "value" : [ {
    "name" : "查找产品功能按钮无效",
    "owner" : "e8ad9e7478c94f4eaf90d5a379af9cb1",
    "path" : "1279401,1279405,1279421",
    "start_date" : "2020-11-30",
    "due_date" : "2020-12-15",
    "region" : "cn-north-7",
    "creator" : "efdb403066474ab08836b9eeaaa23bca",
    "updator" : "3c3bb8f0fab340489cc4563ded7ef63c",
    "project_uuid" : "73ad9ecbf32f44928b51a5d2c96720b8",
    "work_item_id" : "2356888",
    "status_id" : "1",
    "status_name" : "新建",
    "tracker_id" : "7",
    "tracker_name" : "Story",
    "iteration_id" : "12233037",
    "module_id" : "167561",
    "severity_id" : "12",
    "severity_name" : "一般",
    "parent_workitem_id" : "1279405",
    "board_id" : "ad0394a7a27842c281a345ec5d2a8f2c",
    "board_name" : "需求",
    "create_time" : "2025-06-19T11:44:14.146Z",
    "update_time" : "2025-06-19T11:44:14.146Z",
    "iteration_name" : "迭代1",
    "module_name" : "模块1",
    "module_path" : "id1/id2",
    "module_path_name" : "模块1/模块2",
    "owner_name" : "测试Tester",
    "have_child_dynamic" : true,
    "has_child" : true,
    "issue_dynamic_count" : 12,
    "case_count" : 10,
    "sequence_id" : "5875482",
    "pi_id" : "883309798865547265",
    "pi_name" : "12233037"
  } ]
}