更新时间:2022-12-08 GMT+08:00

获取工作项完成率

功能介绍

获取工作项的完成率

URI

GET /v4/projects/{project_id}/issue-completion-rate

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

devcloud项目的32位id

最小长度:32

最大长度:32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

最小长度:10

最大长度:32768

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

issue_completion_rates

Array of issue_completion_rates objects

不同类型的工作项完成率

total

Integer

总数

表4 issue_completion_rates

参数

参数类型

描述

issue_status

issue_status object

工作项不同状态下的数量

tracker_id

Integer

工作项类型id,1需求,2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story

表5 issue_status

参数

参数类型

描述

closed_num

Integer

已关闭的工作项

new_num

Integer

新建的工作项

process_num

Integer

进行中的工作项数目

rejected_num

Integer

已经拒绝的工作项

solved_num

Integer

已经解决的工作项

test_num

Integer

测试中的工作项

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 401

表7 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

GET https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/issue-completion-rate

响应示例

状态码: 200

OK

{
  "issue_completion_rates" : [ {
    "issue_status" : {
      "closed_num" : 0,
      "new_num" : 0,
      "process_num" : 0,
      "rejected_num" : 0,
      "solved_num" : 0,
      "test_num" : 0
    },
    "tracker_id" : 3
  } ],
  "total" : 2
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码