更新时间:2025-08-11 GMT+08:00
分享

查询树状工作项

功能介绍

查询树状工作项

调用方法

请参见如何调用API

URI

POST /v1/ipdprojectservice/projects/{project_id}/issues/tree

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

正则表达式,^[A-Za-z0-9]{32}$。

取值范围

不涉及。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

category

String

参数解释:

工作项类型。

约束限制:

正则表达式:([A-Za-z_,]{2,32})。

取值范围:

系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug,独立软件类项目可选值为:RR/SF/IR/US/Task/Bug,云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。支持多种工作项类型,使用英文逗号分隔,如category=IR,SR,AR。

默认取值:

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

表4 请求Body参数

参数

是否必选

参数类型

描述

keyword

String

参数解释:

关键字。支持标题模糊搜索,编号精确搜索

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

number

Array of strings

参数解释:

按编号批量搜索,number参数有值时,keyword参数不生效。

约束限制:

不涉及。

plan

Array of PlanFilterVO objects

参数解释:

按发布计划、迭代计划条件过滤。参数为发布计划、迭代计划id,迭代计划id和发布计划id有从属关系,-2表示未设置内容

约束限制:

不涉及。

offset

Integer

参数解释:

分页参数—偏移量,从0开始,值为limit的整数倍。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

limit

Integer

参数解释:

分页参数—每页大小。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

默认20。

modified_date

DateFilterVO object

参数解释:

工作项最后修改时间。

约束限制:

不涉及。

表5 PlanFilterVO

参数

是否必选

参数类型

描述

plan_pi

String

参数解释:

发布计划id,-2表示未设置内容。通过发布/迭代计划列表查询接口查询发布计划的id,返回参数中PlanVO里面的id字段即发布计划的id。

约束限制:

正则表达式:([0-9]{18,19})|(-2)。

取值范围:

不涉及。

默认取值:

不涉及。

plan_iteration

Array of strings

参数解释:

发布计划下的迭代计划id,-2表示未设置迭代。按发布计划下迭代计划统计时,迭代计划的id。通过发布/迭代计划列表查询接口查询发布计划的id,返回参数中children里面的id字段即发布迭代的id。

约束限制:

不涉及。

表6 DateFilterVO

参数

是否必选

参数类型

描述

start_date

String

参数解释:

时间过滤器开始时间戳,-2表示未设置内容。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

end_date

String

参数解释:

时间过滤器结束时间戳,-2表示未设置内容。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表7 响应Body参数

参数

参数类型

描述

result

IssueEntityPageResult object

参数解释:

工作项树形列表接口。

status

String

参数解释:

查询状态。

取值范围:

不涉及。

message

String

参数解释:

查询失败的原因。

取值范围:

不涉及。

表8 IssueEntityPageResult

参数

参数类型

描述

issues

Array of IssueInfoVO objects

参数解释:

工作项列表。

total

Integer

参数解释:

工作项总数。

取值范围:

不涉及。

表9 IssueInfoVO

参数

参数类型

描述

id

String

参数解释:

需要更新的工作项id。

取值范围:

不涉及。

默认取值:

不涉及。

title

String

参数解释:

工作项标题。

取值范围:

不涉及。

默认取值:

不涉及。

description

String

参数解释:

工作项描述字段。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

工作项大分类定义。

取值范围:

requirement(研发需求),bug(缺陷),task(任务),feature(特性),raw_requirement(原始需求)。

默认取值:

不涉及。

number

String

参数解释:

工作项编号。

取值范围:

不涉及。

默认取值:

不涉及。

category

String

参数解释:

工作项类型。

取值范围:

系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug。

独立软件类项目可选值为:RR/SF/IR/US/Task/Bug。

云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。

默认取值:

不涉及。

parent_id

String

参数解释:

父工作项id。

取值范围:

不涉及。

默认取值:

不涉及。

project_id

String

参数解释

项目的32位uuid,项目唯一标识。

取值范围:

不涉及

默认取值

不涉及。

status

String

参数解释:

工作项状态code。

取值范围:

不涉及。

默认取值:

不涉及。

state

String

参数解释:

工作项的生命周期,可选值为"正在工作","作废"。

取值范围:

正在工作,作废。

默认取值:

不涉及。

assignee

UserEntity object

参数解释:

工作项责任人。

assigned_cc

Array of UserEntity objects

参数解释:

工作项抄送人,支持多个抄送人。同一工作项最多支持50个抄送人。

created_by

UserEntity object

参数解释:

工作项创建人。

created_time

String

参数解释:

工作项创建时间,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

modified_by

UserEntity object

参数解释:

工作项最近更新人。

modified_time

String

参数解释:

工作项最近更新时间,unix时间戳,单位:毫秒。

取值范围:

不涉及。

默认取值:

不涉及。

plan_end_date

String

参数解释:

工作项计划结束日期,unix时间戳,单位:毫秒。

取值范围:

不涉及。

默认取值:

不涉及。

close_time

String

参数解释:

工作项关闭时间,unix时间戳,单位:毫秒。

取值范围:

不涉及。

默认取值:

不涉及。

workload

String

参数解释:

工作项计划工时,保留一位小数,取值范围为0~999999999.9。

取值范围:

0~999999999.9。

默认取值:

不涉及。

workload_sum

String

参数解释:

工作项计划工时,保留一位小数,取值范围为0~999999999.9,不可编辑。

约束限制:

最小长度:0,最大长度:11。

默认取值:

不涉及。

tenant_id

String

参数解释:

工作项所属租户id,可通过查询树状工作项接口获取,响应消息体中的tenant_id字段的值就是工作项所属租户id。

取值范围:

不涉及。

默认取值:

不涉及。

link

String

参数解释:

工作项关联项id,多个关联项用英文逗号分隔,同一工作项最多支持50个关联项。

取值范围:

不涉及。

默认取值:

不涉及。

suspended

Boolean

参数解释:

工作项是否已挂起。

取值范围:

true,false。

默认取值:

不涉及。

status_modified_time

String

参数解释:

工作项状态改变时间,可用于计算工作项在当前状态停留天数,unix时间戳,单位:毫秒。

取值范围:

不涉及。

默认取值:

不涉及。

labels

Array of LabelEntity objects

参数解释:

工作项标签。

custom_fields

Array of FieldCodeValuePair objects

参数解释:

工作项自定义字段映射,用户添加的系统字段也在此列

{

"code":"字段code",

"value":"字段值"

}。

children

Array of IssueEntity objects

参数解释:

工作项的子工作项集合。

path

String

参数解释:

子工作项的路径。

取值范围:

不涉及。

默认取值:

不涉及。

ir2feature

String

参数解释:

IR和FE的关联字段,工作项类型为IR时,有此字段。

约束限制:

不涉及。

默认取值:

不涉及。

need_break

String

参数解释:

工作项是否需要分解,仅可以分解的工作项类型有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

break_status

String

参数解释:

分解状态,

已分解(decomposed)

未分解(undecomposed)

不涉及( --)。

取值范围:

decomposed,undecomposed,--。

默认取值:

不涉及。

baseline

String

参数解释:

工作项基线状态,

未基线(null)

已基线(baselined)

基线评审中(baseline-reviewing)。

取值范围:

null,baselined,baseline-reviewing。

默认取值:

不涉及。

priority

String

参数解释:

工作项优先级,部分工作项有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

related_network_security

String

参数解释:

是否涉及网络安全。预设字段中,仅研发需求有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

collaboratives

String

参数解释:

研发需求协同信息,协同任务id。

取值范围:

不涉及。

默认取值:

不涉及。

business_domain

String

参数解释:

领域字段。

取值范围:

不涉及。

默认取值:

不涉及。

plan_pi

String

参数解释:

工作项发布计id。

取值范围:

不涉及。

默认取值:

不涉及。

plan_iteration

String

参数解释:

工作项完成的迭代计划id,在Bug中为修复迭代计划id。

取值范围:

不涉及。

默认取值:

不涉及。

change_status

String

参数解释:

工作项变更状态,

变更评审中(change-reviewing)

已变更(changed)

未变更(unchange或null)。

取值范围:

change-reviewing,changed,unchange,null。

默认取值:

不涉及。

no_break_reason

String

参数解释:

无需分解原因,need_break=no时有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

submitted_by

Array of UserEntity objects

参数解释:

工作项提出人。

ir2rr

String

参数解释:

IR关联的RR id,多选时用英文逗号分隔。

取值范围:

不涉及。

默认取值:

不涉及。

feature_set

String

参数解释:

特性集id。

取值范围:

不涉及。

默认取值:

不涉及。

expected_repair_date

String

参数解释:

期望修复时间。预设字段中,仅Bug有此字段,unix时间戳,单位:毫秒。

取值范围:

不涉及。

默认取值:

不涉及。

found_pi

String

参数解释:

缺陷发现发布计划id,预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

found_iteration

String

参数解释:

缺陷发现迭代计划id,预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

reason_analysis

String

参数解释:

分析原因。预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

repair_solution

String

参数解释:

修复方案。预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

test_report

String

参数解释:

测试报告。预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

sys_no_repair_reason

String

参数解释:

无需修复原因。预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

sys_activation_reason

String

参数解释:

激活原因。预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

sys_return_reason

String

参数解释:

退回原因。预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

test_failures_times

Integer

参数解释:

回归不通过次数。预设字段中,仅Bug有此字段。

取值范围:

不涉及。

默认取值:

不涉及。

close_type

String

参数解释:

关闭类型。预设字段中,仅Bug有此字段,可选值为problem_solved,problem_to_requirement,duplicate_problem,not_a_problem。分别对应问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭。

取值范围:

problem_solved,problem_to_requirement,duplicate_problem,not_a_problem。

默认取值:

不涉及。

表10 IssueEntity

参数

参数类型

描述

id

String

参数解释:

需要更新的工作项id,可通过查询树状工作项接口获取,响应消息体中的id字段的值就是工作项id。

约束限制:

正则表达式,^([0-9]{18,19})$

取值范围:

不涉及。

默认取值:

不涉及。

title

String

参数解释:

工作项标题,可通过查询树状工作项接口获取,响应消息体中的title字段的值就是工作项标题。

约束限制:

最小长度:1,最大长度:256。

取值范围:

不涉及。

默认取值:

不涉及。

description

String

参数解释:

工作项描述字段,可通过查询树状工作项接口获取,响应消息体中的description字段的值就是工作项描述字段。

约束限制:

最小长度:1,最大长度:50000。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

工作项大分类定义。工作项创建、编辑无此字段,仅作展示用,可通过查询树状工作项接口获取,响应消息体中的type字段的值就是工作项大分类定义。

约束限制:

最小长度:0,最大长度:128。

取值范围:

requirement(研发需求),bug(缺陷),task(任务),feature(特性),raw_requirement(原始需求)。

默认取值:

不涉及。

number

String

参数解释:

工作项编号,可通过查询树状工作项接口获取,响应消息体中的number字段的值就是工作项编号

约束限制:

最小长度:0,最大长度:128。

取值范围:

不涉及。

默认取值:

不涉及。

category

String

参数解释:

工作项类型,可通过查询树状工作项接口获取,响应消息体中的category字段的值就是工作项类型

约束限制:

不涉及。

取值范围:

系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug。

独立软件类项目可选值为:RR/SF/IR/US/Task/Bug。

云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。

默认取值:

不涉及。

parent_id

String

参数解释:

父工作项id,可通过查询树状工作项接口获取,响应消息体中的parent_id字段的值就是父工作项id

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

正则表达式,[A-Za-z0-9]{32}。

取值范围:

不涉及

默认取值

不涉及。

status

String

参数解释:

工作项状态code,可通过查询树状工作项接口获取,响应消息体中的status字段的值就是工作项状态code。

约束限制:

最小长度:2,最大长度:32。

取值范围:

不涉及。

默认取值:

不涉及。

state

String

参数解释:

工作项的生命周期,可选值为"正在工作","作废",可通过查询树状工作项接口获取,响应消息体中的state字段的值就是工作项的生命周期。

约束限制:

最小长度:2,最大长度:8。

取值范围:

正在工作,作废。

默认取值:

不涉及。

assignee

UserEntity object

参数解释:

工作项责任人。

assigned_cc

Array of UserEntity objects

参数解释:

工作项抄送人,支持多个抄送人。同一工作项最多支持50个抄送人。

created_by

UserEntity object

参数解释:

工作项创建人。

created_time

String

参数解释:

工作项创建时间,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

modified_by

UserEntity object

参数解释:

工作项最近更新人。

modified_time

String

参数解释:

工作项最近更新时间,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

plan_end_date

String

参数解释:

工作项计划结束日期,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

close_time

String

参数解释:

工作项关闭时间,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

workload

String

参数解释:

工作项计划工时,保留一位小数,取值范围为0~999999999.9。

约束限制:

不涉及。

取值范围:

0~999999999.9。

默认取值:

不涉及。

workload_sum

String

参数解释:

工作项计划工时,保留一位小数,取值范围为0~999999999.9,不可编辑。

约束限制:

最小长度:0,最大长度:11。

取值范围:

0~999999999.9。

默认取值:

不涉及。

tenant_id

String

参数解释:

工作项所属租户id,可通过查询树状工作项接口获取,响应消息体中的tenant_id字段的值就是工作项所属租户id。

约束限制:

最小长度:32,最大长度:32。

取值范围:

不涉及。

默认取值:

不涉及。

link

String

参数解释:

工作项关联项id,多个关联项用英文逗号分隔,同一工作项最多支持50个关联项,可通过查询树状工作项接口获取,响应消息体中的link字段的值就是工作项关联项id。

约束限制:

最小长度:0,最大长度:2048。

取值范围:

不涉及。

默认取值:

不涉及。

suspended

Boolean

参数解释:

工作项是否已挂起。

约束限制:

不涉及。

取值范围:

true,false。

默认取值:

不涉及。

status_modified_time

String

参数解释:

工作项状态改变时间,可用于计算工作项在当前状态停留天数,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

labels

Array of LabelEntity objects

参数解释:

工作项标签。

custom_fields

Array of FieldCodeValuePair objects

参数解释:

工作项自定义字段映射,用户添加的系统字段也在此列

{

"code":"字段code",

"value":"字段值"

}。

children

Array of IssueEntity objects

参数解释:

工作项的子工作项集合。

path

String

参数解释:

子工作项的路径。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

ir2feature

String

参数解释:

IR和FE的关联字段,工作项类型为IR时,有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

need_break

String

参数解释:

工作项是否需要分解,仅可以分解的工作项类型有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

break_status

String

参数解释:

分解状态,

已分解(decomposed)

未分解(undecomposed)

不涉及( --)。

约束限制:

不涉及。

取值范围:

decomposed,undecomposed,--。

默认取值:

不涉及。

baseline

String

参数解释:

工作项基线状态,

未基线(null)

已基线(baselined)

基线评审中(baseline-reviewing)。

约束限制:

不涉及。

取值范围:

null,baselined,baseline-reviewing。

默认取值:

不涉及。

priority

String

参数解释:

工作项优先级,部分工作项有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

related_network_security

String

参数解释:

是否涉及网络安全。预设字段中,仅研发需求有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

collaboratives

String

参数解释:

研发需求协同信息,协同任务id,可通过查询树状工作项接口获取,响应消息体中的collaboratives字段的值就是研发需求协同信息,协同任务id。

约束限制:

最小长度:0,最大长度:256。

取值范围:

不涉及。

默认取值:

不涉及。

business_domain

String

参数解释:

领域字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

plan_pi

String

参数解释:

工作项发布计id,可通过查询树状工作项接口获取,响应消息体中的plan_pi字段的值就是工作项发布计id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

plan_iteration

String

参数解释:

工作项完成的迭代计划id,在Bug中为修复迭代计划id,可通过查询树状工作项接口获取,响应消息体中的plan_iteration字段的值就是迭代计划id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

change_status

String

参数解释:

工作项变更状态,

变更评审中(change-reviewing)

已变更(changed)

未变更(unchange或null)。

约束限制:

最小长度:0,最大长度:32。

取值范围:

change-reviewing,changed,unchange,null。

默认取值:

不涉及。

no_break_reason

String

参数解释:

无需分解原因,need_break=no时有此字段

约束限制:

最小长度:0,最大长度:512。

取值范围:

不涉及。

默认取值:

不涉及。

submitted_by

Array of UserEntity objects

参数解释:

工作项提出人。

ir2rr

String

参数解释:

IR关联的RR id,多选时用英文逗号分隔。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

feature_set

String

参数解释:

特性集id,可通过查询树状工作项接口获取,响应消息体中的feature_set字段的值就是特性集id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

expected_repair_date

String

参数解释:

期望修复时间。预设字段中,仅Bug有此字段,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

found_pi

String

参数解释:

缺陷发现发布计划id,预设字段中,仅Bug有此字段,可通过查询树状工作项接口获取,响应消息体中的found_pi字段的值就是缺陷发现发布计划id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

found_iteration

String

参数解释:

缺陷发现迭代计划id,预设字段中,仅Bug有此字段,可通过查询树状工作项接口获取,响应消息体中的found_iteration字段的值就是缺陷发现迭代计划id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

reason_analysis

String

参数解释:

分析原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

repair_solution

String

参数解释:

修复方案。预设字段中,仅Bug有此字段。

约束限制:

最小长度:0,最大长度:50000。

取值范围:

不涉及。

默认取值:

不涉及。

test_report

String

参数解释:

测试报告。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sys_no_repair_reason

String

参数解释:

无需修复原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sys_activation_reason

String

参数解释:

激活原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sys_return_reason

String

参数解释:

退回原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

test_failures_times

Integer

参数解释:

回归不通过次数。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

close_type

String

参数解释:

关闭类型。预设字段中,仅Bug有此字段,可选值为problem_solved,problem_to_requirement,duplicate_problem,not_a_problem。分别对应问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭。

约束限制:

不涉及。

取值范围:

problem_solved,problem_to_requirement,duplicate_problem,not_a_problem。

默认取值:

不涉及。

plan_owner

UserEntity object

参数解释:

工作项规划责任人。

doing_owner

UserEntity object

参数解释:

工作项实现责任人。

delivered_owner

UserEntity object

参数解释:

工作项交付责任人。

checking_owner

UserEntity object

参数解释:

工作项验收责任人。

test_owner

UserEntity object

参数解释:

工作项测试责任人。

develop_owner

UserEntity object

参数解释:

工作项开发责任人。

processing_owner

UserEntity object

参数解释:

工作项处理中责任人。

fixed_owner

UserEntity object

参数解释:

工作项修复责任人。

researchanddevelop_owner

UserEntity object

参数解释:

工作项研发责任人。

analyse_owner

UserEntity object

参数解释:

工作项分析责任人。

表11 LabelEntity

参数

参数类型

描述

id

String

参数解释:

标签id,可通过查询标签列表接口获取,响应消息体中的id字段的值就是标签id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

label_type

String

参数解释:

标签所属工作项类型,对应工作项的type字段。

约束限制:

最小长度:0,最大长度:32。

取值范围:

不涉及。

默认取值:

不涉及。

color

String

参数解释:

标签颜色RGB。

约束限制:

最小长度:0,最大长度:16。

取值范围:

不涉及。

默认取值:

不涉及。

title

String

参数解释:

标签标题。

约束限制:

最小长度:2,最大长度:256。

取值范围:

不涉及。

默认取值:

不涉及。

表12 FieldCodeValuePair

参数

参数类型

描述

code

String

参数解释:

工作项字段code值。

约束限制:

最小长度:0,最大长度:32。

取值范围:

不涉及。

默认取值:

不涉及。

value

String

参数解释:

工作项自定义字段值,为多选时用英文逗号分隔。

约束限制:

最小长度:0,最大长度:10000。

取值范围:

不涉及。

默认取值:

不涉及。

表13 UserEntity

参数

参数类型

描述

id

String

参数解释:

用户id,可通过获取当前用户信息接口获取,响应消息体中的id字段的值就是用户id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

name

String

参数解释:

用户名称。

约束限制:

最小长度:2,最大长度:64。

取值范围:

不涉及。

默认取值:

不涉及。

nick_name

String

参数解释:

用户昵称。

约束限制:

最小长度:2,最大长度:30。

取值范围:

不涉及。

默认取值:

不涉及。

表14 SecurityLevelResult

参数

参数类型

描述

id

String

参数解释:

密级字段id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

display_value

String

参数解释:

密级字段名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

value

String

参数解释:

用户自定义的密级字段的值。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

value:

code

String

参数解释:

密级编码。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sequence

Double

参数解释:

密级排序值,越大级别越高

状态码:400

表15 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

POST https://{endpoint}/v1/ipdprojectservice/projects/8e70d806a8f04d018ea6af6b6ffe7b96/issues/tree?category=IR,US

{
  "keyword" : "IR-",
  "plan" : [ {
    "plan_pi" : "966380919792246785",
    "plan_iteration" : [ "967014561020424192", "-2" ]
  } ],
  "number" : [ "IR20240218102026" ],
  "limit" : 10,
  "offset" : 0
}

响应示例

状态码:200

OK

{
  "status" : "success",
  "message" : null,
  "result" : {
    "issues" : [ {
      "category" : "IR",
      "id" : "961308804339843073",
      "title" : "IR-16-分解",
      "type" : "requirement",
      "number" : "IR20240205000401",
      "project_id" : "8e70d806a8f04d018ea6af6b6ffe7b96",
      "status" : "Start",
      "state" : "正在工作",
      "assignee" : {
        "id" : "a360371833bf4c558f796fd707b44daf",
        "name" : "devcloud_devcloud_s00404480_01",
        "nick_name" : "测试账号"
      },
      "assigned_cc" : [ {
        "id" : "a360371833bf4c558f796fd707b44daf",
        "name" : "devcloud_devcloud_s00404480_01",
        "nick_name" : "测试账号"
      } ],
      "created_by" : {
        "id" : "a360371833bf4c558f796fd707b44daf",
        "name" : "devcloud_devcloud_s00404480_01",
        "nick_name" : "测试账号"
      },
      "created_time" : "1707123479000",
      "modified_by" : {
        "id" : "a360371833bf4c558f796fd707b44daf",
        "name" : "devcloud_devcloud_s00404480_01",
        "nick_name" : "测试账号"
      },
      "modified_time" : "1707123480000",
      "workload" : "20.00",
      "tenant_id" : "4e919d73499648e3b0292cd3cbef806a",
      "link" : "",
      "status_modified_time" : "1707123480000",
      "custom_fields" : [ {
        "code" : "c7073388365101674496",
        "value" : "881467547473321986"
      }, {
        "code" : "c7148512434669625344",
        "value" : "956591616891461634"
      } ],
      "children" : [ ],
      "ir2feature" : "",
      "need_break" : "yes",
      "break_status" : "undecomposed",
      "priority" : "中",
      "related_network_security" : "no",
      "business_domain" : "software",
      "submitted_by" : [ {
        "id" : "a360371833bf4c558f796fd707b44daf",
        "name" : "devcloud_devcloud_s00404480_01",
        "nick_name" : "测试账号"
      } ],
      "ir2rr" : "956559072707911681"
    } ],
    "total" : 1
  }
}

状态码:400

错误信息

{
  "error_code" : "PM.02175000",
  "error_msg" : "系统繁忙,请稍后再试"
}

状态码

状态码

描述

200

OK

400

错误信息

错误码

请参见错误码

相关文档