查询需求树
功能介绍
查询需求树
调用方法
请参见如何调用API。
URI
POST /v4/{project_id}/versions/{version_uri}/issue-tree
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。 |
|
version_uri |
是 |
String |
版本uri |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
iteration_ids |
否 |
Array of strings |
迭代id列表 |
|
pi_sprints |
否 |
Array of IssueListPiFilterInfo objects |
pi过滤条件 |
|
subject |
否 |
String |
需求名 |
|
module_id |
否 |
String |
模块id |
|
status_id |
否 |
String |
需求状态id |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
success|error |
|
result |
ResultValueListWorkItemVo object |
查询需求树结果 |
|
error |
ApiError object |
错误信息 |
|
request_id |
String |
由接口调用方传入，建议使用UUID保证请求的唯一性。 |
|
server_address |
String |
本次请求的受理的服务地址 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
DateTime |
创建时间 |
|
update_time |
DateTime |
更新时间 |
|
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 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
|
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
|
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
|
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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" : {
"total" : 20,
"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"
} ],
"page_size" : 50,
"page_no" : 1,
"has_more" : false
}
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询需求树返回体 |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server Error |
错误码
请参见错误码。
