查询项目的工作项
功能介绍
工作项类型id, 分页参数，创建时间查询项目的工作项
URI
GET /v4/projects/{project_id}/issues
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
devcloud项目的32位id |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
偏移量 从0开始 |
|
limit |
否 |
Integer |
每页数量 最小1,最大100 |
|
tracker_id |
否 |
Integer |
工作项类型 |
|
created_time_interval |
否 |
String |
创建工作项的时间(查询的起始时间,查询的结束时间) |
|
updated_time_interval |
否 |
String |
更新工作项的时间(查询的起始时间,查询的结束时间) |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
issues |
Array of IssueItemSfV4 objects |
工作项 |
|
total |
Integer |
总数 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
工作项更新时间 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
user_id |
String |
用户uuid |
|
user_num_id |
Integer |
用户数字id |
|
id |
Integer |
用户id |
|
name |
String |
带租户名的用户名(租户名_用户名) |
|
nick_name |
String |
昵称 |
|
first_name |
String |
用户名 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
错误描述 |
|
error_code |
String |
错误码 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。
