4.1 Scrum 项目的工作项
4.1.9 高级查询工作项
400 Bad Request 401 Unauthorized
错误码
您可以在API Explorer中调试该接口。
URI
POST /v4/projects/{project_id}/issues
表4-67 路径参数
参数 是否必选 参数类型 描述
project_id 是 String devcloud的项目id 最小长度：32
X-Auth-Token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取（响应
assigned_ids 否 Array of
integers 处理人id creator_ids 否 Array of
integers 创建者id developer_ids 否 Array of
integers 开发人id,对应用户信息的数字id domain_ids 否 Array of
integers id, 领域, 14 '性能', 15 '功能', 16 '可靠性', 17 '网络安全', 18 '可维 护性', 19 '其他DFX', 20 '可用性 ',
done_ratios 否 Array of
integers 完成度 iteration_ids 否 Array of 迭代id
参数 是否必选 参数类型 描述
limit 否 Integer 每页显示数量
最小值：1 最大值：100
offset 否 Integer 分页索引，偏移量，offset是
limit的整数倍数，
limit=10,offset=0,10,20...
最小值：0 module_ids 否 Array of
integers 模块id priority_ids 否 Array of
integers 优先级
query_type 否 String 查询类型 backlog feature epic severity_ids 否 Array of
integers 查询类型 status_ids 否 Array of
integers 状态 id, 开始 1, 进行中 2, 已解 决 3, 测试中 4, 已关闭 5, 已拒 绝 6,
story_point_id
s 否 Array of
integers 故事点id tracker_ids 否 Array of
integers 工作项类型,2任务/task,3缺陷/
bug,5epic,6feature,7story
_interval 否 String 根据工作项的更新时间查询工作
项，(查询的起始时间,查询的结
issues Array of ListIssueItem Response objects
工作项列表
参数 参数类型 描述
total Integer 总数
表4-71 ListIssueItemResponse
参数 参数类型 描述
actual_work_
hours Double 实际工时
assigned_cc_u
ser Array of IssueUser objects
抄送人
assigned_user IssueUser object
begin_time String 预计开始时间，年-月-日 created_time String 创建时间 年-月-日 时:分:秒 creator IssueUser
object custom_fields Array of
CustomField objects
自定义属性值
developer IssueUser object domain domain
object id, 领域 14, '性能', 15, '功能', 16, '可靠性' 17, '网 络安全' 18, '可维护性' 19, '其他DFX' 20, '可用性' done_ratio Integer 工作项进度值
end_time String 预计结束时间，年-月-日 expected_wor
k_hours Double 预计工时
id Integer 工作项项id
project IssueProjectR esponseV4 object
项目信息
iteration iteration
object 迭代
module module
object 模块
name String 标题
参数 参数类型 描述 parent_issue parent_issue
object 父工作项 priority priority
object 工作项优先级 severity severity
object 工作项重要程度 status status object 工作项状态 tracker tracker object 工作项类型
updated_time String 更新时间 年-月-日 时:分:秒 closed_time String 关闭时间 年-月-日 时:分:秒
deleted Boolean 是否已经删除,true 已经删除， false 未删除
表4-72 IssueUser
参数 参数类型 描述
id Integer 用户id
name String 用户名
nick_name String 昵称
表4-73 CustomField
参数 参数类型 描述
name String 自定义属性名
value String 自定义属性对应的值
表4-74 domain
参数 参数类型 描述
id Integer 领域id
name String 领域
表4-75 IssueProjectResponseV4
参数 参数类型 描述
project_id String 项目id project_name String 项目名称 project_num_i
d Integer 项目数字id
表4-76 iteration
参数 参数类型 描述
id Integer 迭代id
name String 迭代名
表4-77 module
参数 参数类型 描述
id Integer 模块id
name String 模块
表4-78 parent_issue
参数 参数类型 描述
id Integer 父工作项id
name String 父工作项
表4-79 priority
参数 参数类型 描述
id Integer 优先级id
name String 优先级
表4-80 severity
参数 参数类型 描述
id Integer 重要程度id
name String 重要程度
表4-81 status
参数 参数类型 描述
id Integer 状态id
name String 状态名称
表4-82 tracker
参数 参数类型 描述
id Integer 类型id
name String 类型名称
状态码： 400
表4-83 响应 Body 参数
参数 参数类型 描述
error_msg String 错误描述 error_code String 错误码
状态码： 401
表4-84 响应 Body 参数
参数 参数类型 描述
error_msg String 错误描述 error_code String 错误码
请求示例
POST https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues
{ "status_ids" : [ 1 ] }
响应示例
无
状态码
状态码 描述
200 OK
400 Bad Request 401 Unauthorized
错误码
请参见错误码。