6.3 获取项目 ID
7.1.4 根据过滤条件获取指定项目的工作项列表
响应示例
无
状态码
状态码 描述
200 OK
错误码
请参见错误码。
7.1.4 根据过滤条件获取指定项目的工作项列表
功能介绍
该接口将于2021年11月1日下线,根据过滤条件获取指定项目的工作项列表
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/projects/{project_id}/issues/query
表7-20 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目id
最小长度:32 最大长度:32
请求参数
表7-21 请求 Header 参数
参数 是否必选 参数类型 描述
x-auth-token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取(响应 消息头中X-Subject-Token的 值)。
表7-22 请求 Body 参数
参数 是否必选 参数类型 描述
page_size 是 Integer 每页显示的数目
最小值:1 最大值:100
page_num 是 Integer 每页显示的数目
最小值:1 最大值:30000
query_type 否 String 查询类型,epic feature backlog assigned_to_i
d 否 Array of
integers 处理人id author_id 否 Array of
integers 创建人id developer_id 否 Array of
integers 开发人id
参数 是否必选 参数类型 描述 domain_id 否 Array of
integers id 领域, 14 '性能', 15 '功能', 16
integers 迭代id module_id 否 Array of
integers 模块id priority_id 否 Array of
integers 优先级 1 低 2 中 3 高 severity_id 否 Array of
integers 重要程度 10 关键 11 重要 12 一般 13 提示
status_id 否 Array of
integers 状态id story_point_id 否 Array of
integers 优先级顺序id tracker_id 否 Array of
integers 1 3 5 7
响应参数
状态码: 200
表7-23 响应 Body 参数
参数 参数类型 描述
error Error object 错误信息 成功:null 异常:返回对应的错误信息 result ProjectIssues
DetailListRes ult object
status String 返回标志 成功 success 失败 error
表7-24 Error
参数 参数类型 描述
code String 异常返回码
message String 异常返回信息
表7-25 ProjectIssuesDetailListResult
参数 参数类型 描述
issues Array of IssueDetail objects total Integer
表7-26 IssueDetail
参数 参数类型 描述
actual_work_
hours Double 实际工时
assigned_cc_u
ser Array of ProjectIssueA ssignCC objects
抄送人
assigned_user ProjectIssueA
ssign object 处理人 author ProjectIssueA
uthor object 创建人 created_on String
custom_field IssueCustom
Field object 自定义工作项属性 developer IssueDevelop
er object domain KeyValueEnti
ty object
done_ratio Integer 完成度 due_date String 完成时间 expected_wor
k_hours Double 预期完成工时 fixed_version KeyValueEnti
ty object
id Long 工作项id
module KeyValueEnti ty object name String
参数 参数类型 描述 parent_issue IssueParent
object
priority KeyValueEnti ty object project IssueProject
object
severity KeyValueEnti ty object
start_date String 开始时间 status KeyValueEnti
ty object type KeyValueEnti
ty object
updated_on String 更新工作项时间
表7-27 ProjectIssueAssignCC
参数 参数类型 描述
id Integer 抄送人id
name String 抄送人
nickname String 抄送人昵称
表7-28 ProjectIssueAssign
参数 参数类型 描述
id Integer 处理人id
name String 处理人
nickname String 处理人昵称
表7-29 ProjectIssueAuthor
参数 参数类型 描述
id Integer 创建人id
name String 创建人
参数 参数类型 描述 nickname String 创建人昵称
表7-30 IssueCustomField
参数 参数类型 描述
custom_field1
6 String
custom_field1
7 String
custom_field1
8 String
custom_field1
9 String
custom_field2
0 String
custom_field2
1 String
custom_field2
2 String
custom_field2
3 String
custom_field2
4 String
custom_field2
5 String
custom_field2
6 String
custom_field2
7 String
custom_field2
8 String
custom_field2
9 String
custom_field3
0 String
custom_field3
1 String
参数 参数类型 描述 custom_field3
2 String
custom_field3
3 String
custom_field3
4 String
custom_field3
5 String
custom_field3
6 String
custom_field3
7 String
custom_field3
8 String
custom_field3
9 String
custom_field4
0 String
表7-31 IssueDeveloper
参数 参数类型 描述
id Integer name String nickname String
表7-32 KeyValueEntity
参数 参数类型 描述
id Integer 属性id
name String 属性名称
表7-33 IssueParent
参数 参数类型 描述
id Integer name String
表7-34 IssueProject
参数 参数类型 描述
id Integer name String project_id String
请求示例
POST https://{endpoint}/v1/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/issues/query' { "page_size" : "1",
"page_num" : "1", "query_type" : ""
}
响应示例
无
状态码
状态码 描述
200 OK
错误码
请参见错误码。