华为云用户手册

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

响应参数 状态码： 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" : "系统繁忙，请稍后再试" }

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. 传项目外的工作项类型会被过滤掉

响应参数 状态码： 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 错误描述

响应示例 状态码： 200 根据快照版本查询特性集返回体 { "status" : "success", "message" : null, "result" : [ { "id" : "981644262727655424", "number" : "FS20240401737948", "parent_id" : null, "title" : "mod1-min-0325-1特性树", "position_float" : 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" : "1711971830000", "modified_date" : "1711971830000", "child_fs" : [ { "id" : "978983008897904641", "number" : "FS20240325720621", "parent_id" : "981644262727655424", "title" : "mod1-min-0325-1 特性树", "position_float" : 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" : "1711337337000", "modified_date" : "1711971830000", "child_fs" : [ { "id" : "981644718250041344", "number" : "FS20240401737949", "parent_id" : "978983008897904641", "title" : "1-1", "position_float" : 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" : "1711971938000", "modified_date" : "1711971938000", "child_fs" : [ { "id" : "981847412113842176", "number" : "FS20240402738983", "parent_id" : "981644718250041344", "title" : "11", "position_float" : 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" : "1712020264000", "modified_date" : "1712020264000", "child_fs" : null } ] }, { "id" : "981644750294523904", "number" : "FS20240401737950", "parent_id" : "978983008897904641", "title" : "1-2", "position_float" : 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" : "1711971946000", "modified_date" : "1711971946000", "child_fs" : [ { "id" : "981644805718056960", "number" : "FS20240401737951", "parent_id" : "981644750294523904", "title" : "1-2-1", "position_float" : 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" : "1711971959000", "modified_date" : "1711971959000", "child_fs" : null }, { "id" : "981644911709302785", "number" : "FS20240401738018", "parent_id" : "981644750294523904", "title" : "1-2-2", "position_float" : 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" : "1711971985000", "modified_date" : "1711972027000", "child_fs" : null } ] } ] } ] } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 状态 message String 消息 result Array of FeatureSetOpenApiVO objects 返回结果 表4 FeatureSetOpenApiVO 参数 参数类型 描述 id String 特性集id number String 编号 parent_id String 父特性集id title String 标题 position_float String 位置信息 created_by UserEntity object 创建人信息 modified_by UserEntity object 修改人信息 created_date String 创建时间 modified_date String 修改时间 child_fs Array of FeatureSetOpenApiVO objects 子特性集 表5 UserEntity 参数 参数类型 描述 id String 用户Id name String 用户名称 nick_name String 用户昵称

请求示例 查询项目b7262b36cfa84b09a27f7896e1fdefc6下快照版本981644868612829184的特性集数据 {url}/v1/ipdprojectservice/projects/b7262b36cfa84b09a27f7896e1fdefc6/feature-set/query?snapshot_version_id=981644868612829184 查询项目b7262b36cfa84b09a27f7896e1fdefc6当前版本的特性集数据 {url}/v1/ipdprojectservice/projects/b7262b36cfa84b09a27f7896e1fdefc6/feature_set/query

URI GET /v1/ipdprojectservice/projects/{project_id}/feature-set/query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 snapshot_version_id 否 String 特性集快照版本id，不传则查询当前版本特性集，传值则查询对应版本的特性集

响应示例 状态码： 200 OK { "records" : [ { "work_item_record_id" : "7401906a85de466c81fd90e22824eb19", "work_item_id" : "4633454879781163008", "project_id" : "526cefde62004de2b62b5e8dd2c2b3af", "work_item_statuses" : [ { "id" : "7401906a85de466c81fd90e22824eb19", "status" : { "id" : "d25fe91f7f6b489db5f804e66ac3b360", "name" : "7401906a85de466c81fd90e22824eb19", "type" : "BACK LOG ", "description" : "demo", "parent_status_id" : "7401906a85de466c81fd90e22824aaaa" } } ] } ], "total" : 1 }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 records Array of WorkitemStatusRecords objects 操作历史 total Integer 总数 表5 WorkitemStatusRecords 参数 参数类型 描述 work_item_record_id String 工作项的记录id，一个工作项对应一条记录 最小长度：32 最大长度：32 work_item_id String 工作项id project_id String devcloud项目的32位id 最小长度：32 最大长度：32 work_item_statuses Array of WorkitemStatus objects 操作历史 表6 WorkitemStatus 参数 参数类型 描述 id String 工作项状态变更记录的id,每次变更产生一条新的记录id 最小长度：1 最大长度：32 status status object 工作项的状态 表7 status 参数 参数类型 描述 id String 工作项的状态id 最小长度：1 最大长度：32 name String 状态名称 最小长度：1 最大长度：60 type String 工作项状态的类型， BACKLOG( "初始化"), READY("待启动"), IN_PROGRESS("进行中"), COMPLETE("已完成"), DONE("已结束"), description String 工作项状态的描述 parent_status_id String 工作项状态的父状态id 最小长度：1 最大长度：32 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

URI GET /v4/projects/{project_id}/work-items/status-records 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 从0开始 最小值：0 缺省值：0 limit 否 Integer 每页数量 最小1,最大100 最小值：1 最大值：100 缺省值：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 fails Array of strings 计算失败的工作项id,一般指未关闭的工作项 data Array of data objects 计算失败的工作项id,一般指未关闭的工作项 total_stay_time Long 停留时间求和（单位：秒） total Integer 停留时间求和的工作项个数 表4 data 参数 参数类型 描述 id String 工作项id字符串 stay_time Long 停留时间（单位：秒） 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表2 请求Body参数 参数 是否必选 参数类型 描述 project_id 否 String 项目uuid issue_ids 否 Array of strings 工作项id字符串列表

请求示例 Post https://{endpoint}/v4/projects/work-hours { "limit" : 1, "offset" : 0, "end_time" : "2020-08-14", "project_ids" : [ "e2da96a5d2c845e284f0ad47f8ca8cb2", "a2da96a5d2c845e284f0ad47f8ca8cef" ] }

响应示例 状态码： 200 ok { "work_hours" : [ { "project_name" : "项目名称", "nick_name" : "用户昵称", "user_id" : "09d75cdd9a00d44d2f17c01875483f26", "user_name" : "用户名", "work_date" : "2020-02-19", "work_hours_num" : "2.0", "summary" : "做了XXXXX", "work_hours_type_name" : "后端开发", "issue_id" : 123456, "issue_type" : "Story", "subject" : "工作项标题", "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 }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：10 最大长度：32768 表2 请求Body参数 参数 是否必选 参数类型 描述 project_ids 否 Array of strings 查询的项目id列表 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 limit 是 Integer 每页显示数量，每页最多显示100条 最小值：1 最大值：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 work_hours Array of work_hours objects 工时列表 total Integer 总数 表4 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 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "total" : 1, "modules" : [ { "module_id" : 1, "module_name" : "demo", "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2", "user_num_id" : 4091, "user_name" : "demo_user_name_06", "nick_name" : "demo" }, "deepth" : 1, "is_parent" : true, "children" : [ { "module_id" : 1, "module_name" : "demo", "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2", "user_num_id" : 4091, "user_name" : "demo_user_name_06", "nick_name" : "demo" }, "deepth" : 1, "is_parent" : true, "parent_module_id" : 1 } ] } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 模块总数 modules Array of ProjectModule objects 模块列表 表5 ProjectModule 参数 参数类型 描述 module_id Integer 模块id module_name String 模块名称 owner ModuleOwner object 模块责任人 deepth Integer 模块层级 is_parent Boolean 是否是父级，true 父模块， false 非父模块 children Array of ProjectChildModule objects 子模块信息 表6 ProjectChildModule 参数 参数类型 描述 module_id Integer 模块id module_name String 模块名称 owner ModuleOwner object 模块责任人 deepth Integer 模块层级 is_parent Boolean 是否是父级，true 父模块， false 非父模块 parent_module_id Integer 父模块id 表7 ModuleOwner 参数 参数类型 描述 user_id String 用户32位字符串id user_num_id Integer 用户数字id user_name String 用户名称 nick_name String 用户昵称 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码