文档首页/ 需求管理 CodeArts Req/ API参考/ API/ Scrum项目的工作项/ 查询项目的工作项
更新时间：2025-06-07 GMT+08:00
查看PDF
分享

查询项目的工作项

功能介绍

工作项类型id, 分页参数，创建时间查询项目的工作项

URI

GET /v4/projects/{project_id}/issues

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

devcloud项目的32位id
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

偏移量 从0开始

limit

否

Integer

每页数量 最小1,最大100

tracker_id

否

Integer

工作项类型

created_time_interval

否

String

创建工作项的时间(查询的起始时间,查询的结束时间)

updated_time_interval

否

String

更新工作项的时间(查询的起始时间,查询的结束时间)

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

issues

Array of IssueItemSfV4 objects

工作项

total

Integer

总数
表5 IssueItemSfV4

参数

参数类型

描述

actual_work_hours

Double

实际工时（实际工时由详细工时自动累加和子工作项自动卷积计算）

assigned_user

IssueUser object

处理人

author

IssueUser object

作者

begin_time

Long

工作项开始时间

closed_time

Long

关闭工作项的时间

created_time

Long

创建时间

custom_feilds

Array of CustomFeildRecord objects

自定义属性

developer

IssueUser object

开发人员

discover_version

String

发现问题的版本

end_time

Long

工作项结束时间

done_ratio

Integer

工作项进度值

expected_work_hours

Double

预计工时

order

Integer

顺序

parent_issue_id

Integer

父工作项的id

release_version

String

发布的版本

root_issue_id

Integer

根工作项的id

story_point

story_point object

参数解释：

故事点id

取值范围：

1（0）

2（1/2）

3（1）

4（2）

5（3）

6（5）

7（8）

8（13）

9（21）

10（40）

11（80）

12（100）

13（∞）

14（?）

domain

domain object

参数解释：

领域信息

取值范围：

14（性能）

15（功能）

16（可靠性）

17（网络安全）

18（可维护性）

19（其他DFX）

20（可用性）

iteration

iteration object

迭代

module

module object

模块

priority

priority object

工作项优先级

severity

severity object

工作项重要程度

status

status object

工作项状态

tracker

tracker object

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

subject

String

工作项标题

updated_time

Long

工作项更新时间
表6 CustomFeildRecord

参数

参数类型

描述

key

String

自定义工作项属性

name

String

自定义工作项名称

value

String

自定义工作项值
表7 IssueUser

参数

参数类型

描述

user_id

String

用户uuid

user_num_id

Integer

用户数字id

id

Integer

用户id

name

String

带租户名的用户名(租户名_用户名)

nick_name

String

昵称

first_name

String

用户名
表8 story_point

参数

参数类型

描述

id

Integer

故事点id

name

String

故事点
表9 domain

参数

参数类型

描述

id

Integer

领域id

name

String

领域
表10 iteration

参数

参数类型

描述

id

Integer

迭代id

name

String

迭代名
表11 module

参数

参数类型

描述

id

Integer

模块id

name

String

模块
表12 priority

参数

参数类型

描述

id

Integer

优先级id

name

String

优先级
表13 severity

参数

参数类型

描述

id

Integer

重要程度id

name

String

重要程度
表14 status

参数

参数类型

描述

id

Integer

状态id

name

String

状态名称
表15 tracker

参数

参数类型

描述

id

Integer

类型id

name

String

类型名称

状态码：400

表16 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码：401

表17 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

Get https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues

Get https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues

响应示例

状态码：200

OK

{
  "issues" : [ {
    "actual_work_hours" : 10,
    "assigned_user" : {
      "id" : 4091,
      "name" : "demo_user_name",
      "nick_name" : "demo"
    },
    "author" : {
      "id" : 4091,
      "name" : "demo_user_name",
      "nick_name" : "demo"
    },
    "begin_time" : 1590940800000,
    "closed_time" : 1590940800000,
    "created_time" : 1590940800000,
    "custom_feilds" : [ {
      "key" : "customField15",
      "name" : "single",
      "value" : "15Demo"
    } ],
    "developer" : {
      "id" : 4091,
      "name" : "demo_user_name",
      "nick_name" : "demo"
    },
    "discover_version" : "ProjectMan 8.0.0",
    "end_time" : 1590940800000,
    "done_ratio" : 0,
    "expected_work_hours" : 9,
    "order" : 1,
    "parent_issue_id" : 123,
    "release_version" : "ProjectMan 8.0.0",
    "root_issue_id" : 0,
    "story_point" : {
      "id" : 1,
      "name" : "0"
    },
    "domain" : {
      "id" : 14,
      "name" : "性能"
    },
    "iteration" : {
      "id" : 456,
      "name" : "迭代1"
    },
    "module" : {
      "id" : 456,
      "name" : "Project"
    },
    "priority" : {
      "id" : 1,
      "name" : "低"
    },
    "severity" : {
      "id" : 12,
      "name" : "一般"
    },
    "status" : {
      "id" : 1,
      "name" : "新建"
    },
    "tracker" : {
      "id" : 7,
      "name" : "story"
    },
    "subject" : "demo",
    "updated_time" : 1576114296000
  } ],
  "total" : 1
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码。