文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 需求管理/ 查询需求树

更新时间：2025-07-25 GMT+08:00

在线调试

CLI示例

查看PDF

查询需求树

功能介绍

查询需求树

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/versions/{version_uri}/issue-tree

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

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
service_type	否	Integer	服务类型
service_types	否	Array of integers	服务类型集合
parent_id	否	String	父节点id
page_number	否	Integer	页码
page_size	否	Integer	每页数量
filter	否	IssueListFilterInfo object	过滤条件
tracker_id	否	String	trackerId
module_id	否	String	模块id
task_uri	否	String	任务udi
include_sub_issue	否	Boolean	是否统计子需求的用例数，默认true

表3 IssueListFilterInfo
参数	是否必选	参数类型	描述
iteration_ids	否	Array of strings	迭代id列表
pi_sprints	否	Array of IssueListPiFilterInfo objects	pi过滤条件
subject	否	String	需求名
module_id	否	String	模块id
status_id	否	String	需求状态id

表4 IssueListPiFilterInfo
参数	是否必选	参数类型	描述
sprints	否	Array of strings	迭代列表
pi_id	否	String	pi的id，层级关系：pi -> 迭代 -> 需求

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
status	String	success\|error
result	ResultValueListWorkItemVo object	查询需求树结果
error	ApiError object	错误信息
request_id	String	由接口调用方传入，建议使用UUID保证请求的唯一性。
server_address	String	本次请求的受理的服务地址

表6 ResultValueListWorkItemVo
参数	参数类型	描述
value	Array of WorkItemVo objects	实际的数据类型：单个对象，集合或 NULL

表7 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	父工作项下是否有子工作项包含动态
has_child	Boolean	父工作项下是否有子工作项
issue_dynamic_count	Integer	需求动态数量
case_count	Integer	用例数量
sequence_id	String	xBoard项目工作项序列号
pi_id	String	pi的id，层级关系：pi -> 迭代 -> 需求
pi_name	String	迭代ID

表8 ApiError
参数	参数类型	描述
code	String	参数解释错误编码取值范围不涉及
reason	String	参数解释业务失败的提示内容取值范围不涉及

状态码：400

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围不涉及
error_msg	String	参数解释接口调用失败错误信息取值范围不涉及

状态码：401

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围不涉及
error_msg	String	参数解释接口调用失败错误信息取值范围不涉及

状态码：404

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围不涉及
error_msg	String	参数解释接口调用失败错误信息取值范围不涉及

状态码：500

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围不涉及
error_msg	String	参数解释接口调用失败错误信息取值范围不涉及

请求示例

post https://{endpoint}/v4/f3087a82b44744c29a1bd69ab6ada154/versions/{version_uri}/issue-tree

{
  "parent_id" : null,
  "page_number" : 1,
  "page_size" : 50
}

响应示例

状态码：200

查询需求树返回体

{
  "status" : "success",
  "result" : {
    "value" : [ {
      "name" : "智能手表可语音遥控手机拍照",
      "work_item_id" : "1140302477026828288",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250613536057"
    }, {
      "name" : "智能手表可语音遥控手机拍照",
      "work_item_id" : "1116809374191366145",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317534"
    }, {
      "name" : "智能手表能控制iOS 手机播放音乐",
      "work_item_id" : "1116809374187171842",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317533"
    }, {
      "name" : "智能手表能控制iOS 手机拍照",
      "work_item_id" : "1116809374187171841",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317532"
    }, {
      "name" : "智能手表能同步查看手机的消息通知",
      "work_item_id" : "1116809374187171840",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317531"
    }, {
      "name" : "智能手表具有兼容性，能控制老华为手机，非鸿蒙手机拍照",
      "work_item_id" : "1116809374182977538",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317530"
    }, {
      "name" : "智能手表可同步手表运动数据至手机",
      "work_item_id" : "1116809374182977537",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317529"
    }, {
      "name" : "智能手表可遥控手机接打电话",
      "work_item_id" : "1116809374178783233",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317528"
    }, {
      "name" : "智能手表能遥控手机拍照",
      "work_item_id" : "1116809374178783232",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317527"
    }, {
      "name" : "智能手表能遥控手机播放音乐",
      "work_item_id" : "1116809374174588929",
      "tracker_id" : "6",
      "tracker_name" : "SF",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "SF20250409317526"
    }, {
      "name" : "【支持同步手机备忘录到手表】",
      "work_item_id" : "1116809374086508544",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317493"
    }, {
      "name" : "【支持查看手机微信消息】智能手表可同步查看手机微信消息",
      "work_item_id" : "1116809374082314243",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317492"
    }, {
      "name" : "智能表遥控拍照支持老华为手机、非鸿蒙手机，与手环体验一致",
      "work_item_id" : "1116809374082314242",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317491"
    }, {
      "name" : "智能手表遥控拍照支持iOS手机",
      "work_item_id" : "1116809374082314241",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317490"
    }, {
      "name" : "【遥控接听电话】智能手表可遥控手机接听电话",
      "work_item_id" : "1116809374078119938",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317489"
    }, {
      "name" : "【遥控播放音乐】智能手表控制手机播放音乐",
      "work_item_id" : "1116809374078119937",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317488"
    }, {
      "name" : "【支持同步运动数据到手机】",
      "work_item_id" : "1116809374078119936",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317487"
    }, {
      "name" : "【特殊任务场景】消息通知来临时延迟提醒-遥控拍照",
      "work_item_id" : "1116809374073925634",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317486"
    }, {
      "name" : "【智慧语音】语音控制手表遥控拍照",
      "work_item_id" : "1116809374073925633",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317485"
    }, {
      "name" : "智能手表作为手机相机遥控器，支持拍照功能",
      "work_item_id" : "1116809374065537024",
      "tracker_id" : "7",
      "tracker_name" : "IR",
      "have_child_dynamic" : false,
      "has_child" : false,
      "issue_dynamic_count" : 0,
      "case_count" : 0,
      "sequence_id" : "IR20250409317484"
    } ]
  }
}

状态码

状态码	描述
200	查询需求树返回体
400	Bad Request
401	Unauthorized
404	Not Found
500	Internal Server Error

错误码

请参见错误码。

父主题： 需求管理

上一篇：需求管理

下一篇：获取项目需求树

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

查询需求树

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？