华为云用户手册

响应示例 状态码： 200 查询特性集快照版本返回体 { "status" : "success", "message" : null, "result" : [ { "id" : "981644868612829184", "title" : "1-2-1快照", "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711971974000", "modified_date" : "1711971974000" }, { "id" : "981645326705139713", "title" : "1-2-2快照", "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711972083000", "modified_date" : "1711972083000" }, { "id" : "982005155140513792", "title" : "等同于当前版本", "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1712057873000", "modified_date" : "1712057873000" } ] } 状态码： 400 { "error_code" : "PM.02174103", "error_msg" : "无操作权限" }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 状态 message String 消息 result Array of SnapshotsTitleVO objects 数据返回 表3 SnapshotsTitleVO 参数 参数类型 描述 id String 特性集快照版本id title String 特性集快照版本标题 created_by UserEntity object 创建人信息 modified_by UserEntity object 最近修改人信息 created_date String 创建时间戳 modified_date String 最新修改时间戳 表4 UserEntity 参数 参数类型 描述 id String 用户Id name String 用户名称 nick_name String 用户昵称 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求示例 根据快照版本id和特性集id查询特性 {url}/v1/ipdprojectservice/projects/b7262b36cfa84b09a27f7896e1fdefc6/snapshots-feature/query?snapshot_version_id=982005155140513792&feature_set_id=981644262727655424&offset=0&limit=1

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 result IssueEntityPageResult object 工作项树形列表接口 status String 查询状态 message String 查询失败的原因 表4 IssueEntityPageResult 参数 参数类型 描述 issues Array of IssueEntity objects 工作项列表 total Integer 工作项总数 表5 IssueEntity 参数 参数类型 描述 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 工作项所属的项目id status String 工作项状态code state String 工作项的生命周期，可选值为"正在工作","作废" assignee UserEntity object 工作项责任人 assigned_cc Array of UserEntity objects 工作项抄送人，支持多个抄送人。同一工作项最多支持50个抄送人 created_by UserEntity object 工作项创建人 created_time String 工作项创建时间 modified_by UserEntity object 工作项最近更新人 modified_time String 工作项最近更新时间 plan_end_date String 工作项计划结束日期，时间戳 close_time String 工作项关闭时间 workload String 工作项计划工时，保留一位小数，取值范围为0~999999999.9 workload_sum String 工作项计划工时，保留一位小数，取值范围为0~999999999.9，不可编辑 tenant_id String 工作项所属租户id link String 工作项关联项id，多个关联项用英文逗号分隔，同一工作项最多支持50个关联项 suspended Boolean 工作项是否已挂起 status_modified_time String 工作项状态改变时间，可用于计算工作项在当前状态停留天数 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 不涉及— -- baseline String 工作项基线状态 未基线 —— null 已基线 —— baselined 基线评审中——baseline-reviewing priority String 工作项优先级，部分工作项有此字段 related_network_security String 是否涉及网络安全。预设字段中，仅研发需求有此字段 collaboratives String 研发需求协同信息，协同任务id business_domain String 领域字段 plan_pi String 工作项发布(老版本名为PI) id plan_iteration String 工作项完成的迭代，在Bug中为修复迭代 change_status String 工作项变更状态 变更评审中——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有此字段 found_pi String 缺陷发现发布。预设字段中，仅Bug有此字段 found_iteration String 缺陷发现迭代。预设字段中，仅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有此字段;可选值为 问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭 表6 UserEntity 参数 参数类型 描述 id String 用户Id name String 用户名称 nick_name String 用户昵称 表7 LabelEntity 参数 参数类型 描述 id String 标签id label_type String 标签所属工作项类型，对应工作项的type字段 color String 标签颜色RGB title String 标签标题 表8 FieldCodeValuePair 参数 参数类型 描述 code String 工作项字段code值 value String 工作项自定义字段值，为多选时用英文逗号分隔

URI GET /v1/ipdprojectservice/projects/{project_id}/snapshots-feature/query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 snapshot_version_id 是 String 特性集快照版本id feature_set_id 是 String 特性集id，会根据当前id往下检索，传入根节点id，则查询所有的特性集数据 offset 否 String 分页参数—偏移量，从0开始，值为limit的整数倍.默认0 limit 否 String 分页参数—每页大小。默认200

响应示例 状态码： 200 ok { "work_hours" : [ { "project_name" : "demo", "nick_name" : "demo", "user_id" : "09d75cdd9a00d44d2f17c01875483f26", "user_name" : "userName", "work_date" : "2020-02-19", "work_hours_num" : "2.0", "summary" : "summaryXXXXX", "work_hours_type_name" : "后端开发", "issue_id" : 123456, "issue_type" : "Story", "subject" : "title", "created_time" : "2019-12-17", "closed_time" : "2019-12-20", "work_hours_created_time" : "2019-12-17 09:00:00", "work_hours_updated_time" : "2019-12-20 15:00:00" } ], "total" : 1 }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：10 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 user_ids 否 Array of strings 查询的用户id列表 work_hours_types 否 String 工时类型，以逗号分隔,21:研发设计,22:后端开发,23:前端开发(Web),24:前端开发(小程序),25:前端开发(App),26:测试验证,27:缺陷修复,28:UI设计,29:会议,30:公共事务,31:培训,32:研究,33:其它,34:调休请假 work_hours_dates 否 String 工时日期，以逗号分隔，年-月-日 begin_time 否 String 工时开始日期，年-月-日 end_time 否 String 工时结束日期，年-月-日 offset 是 Integer 偏移量,offset是limit的整数倍，limit=10,offset=0,10,20... 最小值：0 缺省值：0 limit 是 Integer 每页显示数量，每页最多显示100条 最小值：1 最大值：100 缺省值：10

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 work_hours Array of work_hours objects 工时列表 total Integer 总数 表5 work_hours 参数 参数类型 描述 project_name String 项目名称 nick_name String 用户昵称 user_id String 用户id user_name String 用户名 work_date String 工时日期 work_hours_num String 工时花费 summary String 工时内容 work_hours_type_name String 工时类型 issue_id Integer 工作项id issue_type String 工作项类型 subject String 工作项标题 created_time String 工作项创建时间 closed_time String 工作项结束时间 work_hours_created_time String 工时创建时间 work_hours_updated_time String 工时更新时间 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 bug_statistics Array of BugStatisticResponseV4 objects bug统计列表 demand_statistics Array of DemandStatisticResponseV4 objects 按模块统计列表 issue_completion_rates Array of IssueCompletionRateResponseV4 objects 按工作项类型统计列表 project_id String 项目的32位id，项目唯一标识 表4 BugStatisticResponseV4 参数 参数类型 描述 critical_num Integer 重要程度为关键的缺陷数，重要程度为关键对应id为10 defect_index Double DI值，不同重要程度的缺陷对应不同的分值 module String 模块 normal_num Integer 重要程度为一般的缺陷数，重要程度为一般对应id为12 serious_num Integer 重要程度为严重的缺陷数，重要程度为严重对应id为11 tip_num Integer 重要程度为提示的缺陷数，重要程度为提示对应id为13 total Integer 当前项目下bug统计总数 表5 DemandStatisticResponseV4 参数 参数类型 描述 closed_num Integer 按模块统计已关闭数量 module String 模块 new_num Integer 按模块统计新建的数量 process_num Integer 按模块统计开发中的数量 rejected_num Integer 按模块统计已拒绝数量 solved_num Integer 按模块统计已解决数量 test_num Integer 按模块统计测试中的数量 total Integer 按模块统计总数 表6 IssueCompletionRateResponseV4 参数 参数类型 描述 issue_status IssueStatusResponseV4 object 工作项状态维度的统计信息 tracker_id Integer 工作项类型,2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story 表7 IssueStatusResponseV4 参数 参数类型 描述 closed_num Integer 当前项目中工作项已关闭数量 new_num Integer 当前项目中工作项新建的数量 process_num Integer 当前项目中工作项开发中的数量 rejected_num Integer 当前项目中工作项已拒绝数量 solved_num Integer 当前项目中工作项已解决数量 test_num Integer 当前项目中工作项测试中的数量 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "bug_statistics" : [ { "critical_num" : 0, "defect_index" : 1, "module" : "统计分数", "normal_num" : 1, "serious_num" : 0, "tip_num" : 0, "total" : 1 } ], "demand_statistics" : [ { "closed_num" : 1, "module" : "计费", "new_num" : 1, "process_num" : 1, "rejected_num" : 1, "solved_num" : 1, "test_num" : 1, "total" : 1 } ], "issue_completion_rates" : [ { "issue_status" : { "closed_num" : 1, "new_num" : 1, "process_num" : 1, "rejected_num" : 1, "solved_num" : 1, "test_num" : 1 }, "tracker_id" : 0 } ], "project_id" : "526cefde62004de2b62b5e8dd2c2b3af" }

响应示例 状态码： 200 OK { "begin_time" : "2020-07-12", "charts" : [ { "date" : "2020-09-12", "finished_num" : 1, "iteration_id" : 3789, "project_num_id" : 36587463, "remaining_num" : 3, "total" : 4 } ], "closed_total" : 1, "created_time" : "2020-06-31 09:10:03", "end_time" : "2020-07-19", "have_task" : false, "iteration_id" : 35789, "name" : "迭代1", "opened_total" : 3, "progress" : "25%", "total" : 4, "updated_time" : "2020-06-31 09:10:03", "status" : "0" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 begin_time String 迭代结束时间，年-月-日 charts Array of Chart objects 燃尽图 closed_total Integer 已关闭的工单数 created_time String 迭代创建时间 end_time String 迭代开始时间，年-月-日 have_task Boolean 是否有task iteration_id Integer 迭代id name String 迭代标题 opened_total Integer 开启的工单数 progress String 工作进展 total Integer 工单总数 updated_time String 迭代更新时间 status String 迭代的状态,0 未开始，1 进行中，2 结束 表4 Chart 参数 参数类型 描述 date String 统计时间 finished_num Integer 完成story工单 iteration_id Integer 迭代id project_num_id Integer 项目id remaining_num Integer 未完成story数 total Integer 总story数 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

请求示例 GET https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues/workflow/config?tracker_id=7 GET https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues/workflow/config?tracker_id=7

URI GET /v4/projects/{project_id}/issues/workflow/config 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 tracker_id 是 Integer 工作项类型id [2,3,4,5,6,7]

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 workflows Array of ScrumStatusFlowVo objects 流转数据 表5 ScrumStatusFlowVo 参数 参数类型 描述 id String 流转数据的uuid name String 状态名称 status_id Integer 状态id direct_to Array of ScrumStatusFlowDirectToVo objects 流转到的数据 表6 ScrumStatusFlowDirectToVo 参数 参数类型 描述 id String 流转数据的uuid status_id Integer 状态id name String 状态名 enabled Boolean 是否开启流转 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "workflows" : [ { "id" : "2e645dbab6874a3eafa77ef06b97ea75", "name" : "新建", "status_id" : 1, "direct_to" : [ { "id" : "2e645dbab6874a3eafa77ef06b97ea75", "status_id" : 2, "name" : "新建", "enabled" : true } ] } ] }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 result Array of DashboardSimpleVO objects 统计结果 status String 请求状态 message String 请求失败信息 表7 DashboardSimpleVO 参数 参数类型 描述 category String 工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug total Integer 工作项总数 processing Integer 处理中的工作项数量 completed Integer 已完成的工作项数量 expired Integer 已超期的工作项数量 remain_di Double 缺陷的遗留DI，统计范围为该项目下所有非关闭态、非草稿态的缺陷 DI计算规则: DI=提示0.1 + 一般1 +严重3 + 致命10 category_name String 统计面板名称 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

响应示例 状态码： 200 统计成功响应 { "status" : "success", "message" : null, "result" : [ { "category" : "RR", "total" : 0, "processing" : 0, "completed" : 0, "expired" : 0, "category_name" : "原始需求" }, { "category" : "SF", "total" : 2, "processing" : 1, "completed" : 0, "expired" : 0, "category_name" : "系统特性" }, { "category" : "IR", "total" : 2, "processing" : 1, "completed" : 0, "expired" : 1, "category_name" : "初始需求" }, { "category" : "SR", "total" : 1, "processing" : 0, "completed" : 0, "expired" : 0, "category_name" : "系统需求" }, { "category" : "AR", "total" : 1, "processing" : 0, "completed" : 0, "expired" : 0, "category_name" : "分配需求" }, { "category" : "Task", "total" : 1, "processing" : 0, "completed" : 0, "expired" : 0, "category_name" : "任务" }, { "category" : "Bug", "total" : 5, "processing" : 0, "completed" : 0, "expired" : 0, "category_name" : "缺陷" } ] } 状态码： 400 统失败响应 { "error_code" : "PM.02175302", "error_msg" : "服务繁忙:ISSUE_SERVICE" }

URI POST /v1/ipdprojectservice/projects/{project_id}/statistic/dashboard 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目Id 表2 Query参数 参数 是否必选 参数类型 描述 classification 是 String 标识统计类型，可选值为requirement，bug classification=requirement 查询需求统计 classification=bug 查询缺陷统计

请求参数 表3 请求Body参数 参数 是否必选 参数类型 描述 plan 否 PlanFilter object 统计概览按PI迭代过滤条件 created_date 否 DateFilter object 按创建时间统计时，起止时间过滤条件 表4 PlanFilter 参数 是否必选 参数类型 描述 plan_pi 否 String 按PI统计时，被统计的PI的id plan_iteration 否 String 按PI下迭代统计时，迭代的id 表5 DateFilter 参数 是否必选 参数类型 描述 start_date 否 String 工作项创建时间不早于此时间，日期d的0点时间戳 end_date 否 String 工作项创建时间不晚于此时间，日期d+1的0点时间戳

响应示例 状态码： 200 成功响应 { "status" : "success", "message" : null, "result" : [ { "user_id" : "a360371833bf4c558f796fd707b44daf", "user_num_id" : 4091, "user_name" : "devcloud_devcloud_s00404480_01", "domain_id" : "4e919d73499648e3b0292cd3cbef806a", "domain_name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号", "role_id" : "8dc2cd191a104148a77f937681f9a5d6,6af50476ba89492698d237fb6fa456d6", "role_name" : "项目管理员,项目经理" } ] }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 状态 message String 失败信息 result Array of UserVO objects 用户信息列表 表3 UserVO 参数 参数类型 描述 user_id String 用户Id user_num_id Integer 用户短Id user_name String 用户名称 domain_id String 用户所属域Id domain_name String 租户名称 nick_name String 用户昵称 role_id String 角色Id，用户在项目中具有多个角色时用英文逗号分隔 role_name String 用户角色名称，多个角色用英文逗号分隔

响应示例 状态码： 200 OK { "status" : "success", "message" : null, "result" : { "modules" : [ { "id" : "958663834527117312", "sequence" : "1.0", "level" : 1, "description" : "aaaa", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1706492869000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1706492869000", "display_value" : "模块A", "path_name" : "模块A", "value" : "958663834527117312", "child_modules" : [ { "id" : "958663880396025857", "sequence" : "1.0", "level" : 2, "description" : "aaa1", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1706492880000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1706492880000", "display_value" : "模块A-1", "path_name" : "模块A/模块A-1", "value" : "958663880396025857", "parent_id" : "958663834527117312", "child_modules" : [ { "id" : "958663903372423168", "sequence" : "1.0", "level" : 3, "description" : "", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1706492885000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1706492885000", "display_value" : "模块A-1-1", "path_name" : "模块A/模块A-1/模块A-1-1", "value" : "958663903372423168", "parent_id" : "958663880396025857", "assignee" : "a360371833bf4c558f796fd707b44daf" } ], "assignee" : "a360371833bf4c558f796fd707b44daf" } ], "assignee" : "a360371833bf4c558f796fd707b44daf" } ], "total" : 1 } } 状态码： 400 错误信息 { "error_code" : "PM.02174103", "error_msg" : "分页参数错误" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 result ModuleListResult object 模块列表 status String 查询结果状态 message String 错误信息 表4 ModuleListResult 参数 参数类型 描述 modules Array of ModuleEntity objects 模块列表 total Integer 模块总数，项目下模块最多允许350个(包含子模块) 表5 ModuleEntity 参数 参数类型 描述 id String 模块id sequence String 模块顺序值。double类型 level Integer 模块层级，最多3层 description String 模块描述信息 created_by String 模块创建人id created_time String 模块创建时间 modified_by String 模块最近修改人id modified_time String 模块最近修改时间 display_value String 模块显示名 path_name String 子模块的路径名 value String 模块唯一标识，自定义模块value和id项目 parent_id String 父模块id child_modules Array of ModuleEntity objects 子模块 assignee String 模块责任人id 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI GET /v1/ipdprojectservice/projects/{project_id}/modules/tree 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目 id 表2 Query参数 参数 是否必选 参数类型 描述 key_word 否 String 按关键字搜索，当前仅支持按名称关键字搜索 sort 否 String 排序规则，默认为创建时间降序，即最新创建的排在最前面 sort_type 否 String 排序方式，可选值为：asc、desc，asc表示升序，desc表示降序，默认为desc offset 否 Integer 分页起始，从0开始，为limit整数倍,默认为0 limit 否 Integer 分页大小，默认为10

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 请求状态 message String 请求失败信息 data IssueEntity object 工作项详情 表4 IssueEntity 参数 参数类型 描述 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 工作项所属的项目id status String 工作项状态code state String 工作项的生命周期，可选值为"正在工作","作废" assignee UserEntity object 工作项责任人 assigned_cc Array of UserEntity objects 工作项抄送人，支持多个抄送人。同一工作项最多支持50个抄送人 created_by UserEntity object 工作项创建人 created_time String 工作项创建时间 modified_by UserEntity object 工作项最近更新人 modified_time String 工作项最近更新时间 plan_end_date String 工作项计划结束日期，时间戳 close_time String 工作项关闭时间 workload String 工作项计划工时，保留一位小数，取值范围为0~999999999.9 workload_sum String 工作项计划工时，保留一位小数，取值范围为0~999999999.9，不可编辑 tenant_id String 工作项所属租户id link String 工作项关联项id，多个关联项用英文逗号分隔，同一工作项最多支持50个关联项 suspended Boolean 工作项是否已挂起 status_modified_time String 工作项状态改变时间，可用于计算工作项在当前状态停留天数 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 不涉及— -- baseline String 工作项基线状态 未基线 —— null 已基线 —— baselined 基线评审中——baseline-reviewing priority String 工作项优先级，部分工作项有此字段 related_network_security String 是否涉及网络安全。预设字段中，仅研发需求有此字段 collaboratives String 研发需求协同信息，协同任务id business_domain String 领域字段 plan_pi String 工作项发布(老版本名为PI) id plan_iteration String 工作项完成的迭代，在Bug中为修复迭代 change_status String 工作项变更状态 变更评审中——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有此字段 found_pi String 缺陷发现发布。预设字段中，仅Bug有此字段 found_iteration String 缺陷发现迭代。预设字段中，仅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有此字段;可选值为 问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭 表5 UserEntity 参数 参数类型 描述 id String 用户Id name String 用户名称 nick_name String 用户昵称 表6 LabelEntity 参数 参数类型 描述 id String 标签id label_type String 标签所属工作项类型，对应工作项的type字段 color String 标签颜色RGB title String 标签标题 表7 FieldCodeValuePair 参数 参数类型 描述 code String 工作项字段code值 value String 工作项自定义字段值，为多选时用英文逗号分隔

URI GET /v2/ipdprojectservice/projects/{project_id}/issues/{issue_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目Id issue_id 是 String 工作项Id 表2 Query参数 参数 是否必选 参数类型 描述 category 是 String 工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug

响应示例 状态码： 200 OK { "status" : "success", "message" : null, "result" : { "status" : [ { "id" : "954399210965348356", "belonging" : "START", "display_value" : "初始", "code" : "Start", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "IR", "SR" ] }, { "id" : "954399210965348363", "belonging" : "START", "display_value" : "分析", "code" : "Analyse", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug", "IR", "SR" ] }, { "id" : "958806581085904896", "belonging" : "IN_PROGRESS", "display_value" : "openapi-test", "code" : "s7150727397899378688", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1706526902000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1706526902000", "category_code" : [ "IR" ] }, { "id" : "954399210965348376", "belonging" : "IN_PROGRESS", "display_value" : "测试", "code" : "Test", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug", "IR", "SR" ] }, { "id" : "954399210965348369", "belonging" : "IN_PROGRESS", "display_value" : "开发", "code" : "Develop", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "IR", "SR" ] }, { "id" : "954399210961154063", "belonging" : "IN_PROGRESS", "display_value" : "确认", "code" : "ToBeConfirmed", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210965348354", "belonging" : "IN_PROGRESS", "display_value" : "修复", "code" : "Fixed", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210961154057", "belonging" : "IN_PROGRESS", "display_value" : "验收", "code" : "Checking", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210961154060", "belonging" : "END", "display_value" : "关闭", "code" : "Closed", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210965348381", "belonging" : "END", "display_value" : "完成", "code" : "Finish", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "IR", "SR" ] } ] } } 状态码： 400 { "error_code": "PM.02175903", "error_msg": "工作项类型错误" } { "error_code" : "PM.02175000", "error_msg" : "系统繁忙，请稍后再试" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 result StatusListResult object 状态列表 status String 查询结果状态 message String 错误信息 表4 StatusListResult 参数 参数类型 描述 status Array of StatusEntity objects 状态列表 表5 StatusEntity 参数 参数类型 描述 id String 状态id belonging String 工作项的状态属性，START、IN_PROGRESS、END display_value String 状态名 code String 状态唯一标识 created_by String 状态创建人 created_time String 状态创建时间 modified_by String 状态修改人 modified_time String 状态最近修改时间 category_code Array of strings 状态被哪些工作项使用 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI GET /v1/ipdprojectservice/projects/{project_id}/status 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 categories 是 String 工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug.支持多种工作项类型，使用英文逗号分隔,如category=IR,SR,AR. 传项目外的工作项类型会被过滤掉