向迭代中添加需求
功能介绍
向迭代中添加需求
调用方法
请参见如何调用API。
URI
POST /GT3KServer/v4/{project_id}/iterators/{iterator_id}/issues
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。 |
iterator_id |
是 |
String |
迭代uri |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
workitem_list |
是 |
Array of WorkItemInfo objects |
关联需求 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
work_item_id |
是 |
String |
参数解释 工作项编号 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
has_child |
是 |
Boolean |
参数解释 是否有子需求 约束限制 不涉及 取值范围 true:是 false:否 默认取值 不涉及 |
is_open |
是 |
Boolean |
参数解释 是否展开 约束限制 不涉及 取值范围 true:是 false:否 默认取值 不涉及 |
child_list |
否 |
Array of WorkItemInfo objects |
参数解释 子需求集合 约束限制 不涉及 取值范围 true:是 false:否 默认取值 不涉及 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
success|error |
result |
ResultValueString object |
请求结果 |
error |
ApiError object |
错误信息 |
request_id |
String |
由接口调用方传入,建议使用UUID保证请求的唯一性。 |
server_address |
String |
本次请求的受理的服务地址 |
参数 |
参数类型 |
描述 |
---|---|---|
total |
Integer |
起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 |
value |
String |
实际的数据类型:单个对象,集合 或 NULL |
reason |
String |
业务失败的提示内容 |
page_size |
Integer |
分页大小 |
page_no |
Integer |
分页编码 |
has_more |
Boolean |
是否有更多 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg |
String |
参数解释 接口调用失败错误信息 取值范围 不涉及 |
请求示例
post https://{endpoint}/GT3KServer/v4/9a5b66157ff44f6f80ce5f0fd1709f21/iterators/v92s00010htm0ehf/issues { "workitem_list" : [ { "work_item_id" : "1140302477026828288", "has_child" : false, "is_open" : false, "child_list" : [ ] }, { "work_item_id" : "1116809374191366145", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374187171842", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374187171841", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374187171840", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374182977538", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374182977537", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374178783233", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374178783232", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374174588929", "has_child" : false, "is_open" : true, "child_list" : [ ] }, { "work_item_id" : "1116809374086508544", "has_child" : false, "is_open" : true, "child_list" : [ ] } ] }
响应示例
状态码:200
向迭代中添加需求响应体
{ "status" : "success", "result" : { "value" : "success" } }
状态码
状态码 |
描述 |
---|---|
200 |
向迭代中添加需求响应体 |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。