获取子工作项
功能介绍
获取子工作项
调用方法
请参见如何调用API。
URI
GET /v4/projects/{project_id}/issues/{issue_id}/child
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 最小长度:10,最大长度:32768。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
issues |
Array of IssueResponseV4 objects |
参数解释: 工作项列表。 |
|
total |
Integer |
参数解释: 总数。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
actual_work_hours |
Double |
参数解释: 实际工时 取值范围: 最小值:0 |
|
assigned_cc_user |
Array of IssueUser objects |
参数解释: 抄送人 |
|
assigned_user |
IssueUser object |
参数解释: 处理人 |
|
begin_time |
String |
参数解释: 预计开始时间,日期格式:YYYY-MM-DD 取值范围: 不涉及 |
|
closed_time |
String |
参数解释: 关闭时间,日期格式:YYYY-MM-DD 取值范围: 不涉及 |
|
created_time |
String |
参数解释: 创建时间,日期格式:YYYY-MM-DD HH:MM:SS 取值范围: 不涉及 |
|
creator |
IssueUser object |
参数解释: 创建人 |
|
custom_fields |
Array of CustomField objects |
参数解释: 自定义属性值,不建议使用,建议参考new_custom_fields字段 |
|
developer |
IssueUser object |
参数解释: 开发人员 |
|
domain |
domain object |
参数解释: 领域 |
|
done_ratio |
Integer |
参数解释: 工作项完成度 ,如20,表示完成度为20% 取值范围: 最小值 0 最大值 100 |
|
end_time |
String |
参数解释: 预计结束时间,日期格式:YYYY-MM-DD 取值范围: 不涉及 |
|
expected_work_hours |
Double |
参数解释: 预计工时 取值范围: 最小值:0 |
|
id |
Integer |
参数解释: 工作项id 取值范围: 0至9999999999 |
|
iteration |
iteration object |
参数解释: 迭代 |
|
module |
module object |
参数解释: 模块 |
|
name |
String |
参数解释: 标题 取值范围: 不涉及 |
|
new_custom_fields |
Array of NewCustomField objects |
参数解释: 自定义属性值 |
|
parent_issue |
parent_issue object |
参数解释: 父工作项 |
|
priority |
priority object |
参数解释: 工作项优先级 |
|
project |
IssueProjectResponseV4 object |
参数解释: 项目信息 |
|
severity |
severity object |
参数解释: 工作项重要程度 |
|
status |
status object |
参数解释: 工作项状态 |
|
tracker |
tracker object |
参数解释: 工作项类型 |
|
updated_time |
String |
参数解释: 更新时间,日期格式:YYYY-MM-DD HH:MM:SS 取值范围: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
参数解释: 用户id。 取值范围: 不涉及。 |
|
name |
String |
参数解释: 带租户名的用户名(租户名_用户名)。 取值范围: 不涉及。 |
|
nick_name |
String |
参数解释: 昵称。 取值范围: 不涉及。 |
|
user_id |
String |
参数解释: 用户uuid。 取值范围: 不涉及。 |
|
user_num_id |
Integer |
参数解释: 用户数字id。 取值范围: 不涉及。 |
|
first_name |
String |
参数解释: 用户名。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数解释: 自定义属性名。 取值范围: 不涉及。 |
|
new_name |
String |
参数解释: 自定义属性名。 取值范围: 不涉及。 |
|
value |
String |
参数解释: 自定义属性对应的值。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
参数解释: 领域id,枚举: 14(性能) 15(功能) 16(可靠性) 17(网络安全) 18(可维护性) 19(其他DFX) 20(可用性) 取值范围: 14,15,16,17,18,19,20 |
|
name |
String |
参数解释: 领域名称 取值范围: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
custom_field |
String |
参数解释: 自定义字段,可以通过查询Scrum工作项自定义字段接口查询Scrum工作项自定义字段中返回的custom_field值获取。 约束限制: 可以为空。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
field_name |
String |
参数解释: 自定义属性对应的值,多个值以英文逗号区分开, 可以通过查询Scrum工作项自定义字段接口查询Scrum工作项自定义字段中返回的name值获取。 约束限制: 可以为空。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
value |
String |
参数解释: 自定义属性对应的值,多个值以英文逗号区分开, 可以通过查询Scrum工作项自定义字段接口查询Scrum工作项自定义字段中返回的options值获取。 约束限制: 可以为空。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
参数解释: 优先级id,枚举: 1(低) 2(中) 3(高) 取值范围: 1,2,3 |
|
name |
String |
参数解释: 优先级 取值范围: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
project_id |
String |
参数解释: 项目id。 取值范围: 不涉及。 |
|
project_name |
String |
参数解释: 项目名称。 取值范围: 不涉及。 |
|
project_num_id |
Integer |
参数解释: 项目数字id。 取值范围: 最小值:0。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
参数解释: 重要程度id,枚举: 10 (关键) 11 (重要) 12 (一般) 13 (提示) 取值范围: 10,11,12,13 |
|
name |
String |
参数解释: 重要程度 取值范围: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
参数解释: 状态id,枚举: 1(新建) 2(进行中) 3(已解决) 4(测试中) 5( 已关闭) 6(已拒绝) 取值范围: 1,2,3,4,5,6 |
|
name |
String |
参数解释: 状态名称 取值范围: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
参数解释: 类型id,枚举: 2(任务/Task) 3(缺陷/Bug) 5(Epic) 6(Feature) 7(Story) 取值范围: 2,3,5,6,7 |
|
name |
String |
参数解释: 类型名称 取值范围: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 密级编码。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
name |
String |
参数解释: 密级字段名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
sequence |
Integer |
参数解释: 密级排序值,越大级别越高 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
状态码:401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
请求示例
GET https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues/4568921/child
响应示例
状态码:200
OK
{
"issues" : [ {
"actual_work_hours" : 0,
"assigned_cc_user" : [ {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "张三"
} ],
"assigned_user" : {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "张三"
},
"begin_time" : "2020-09-12",
"created_time" : "2020-09-13 14:40:11",
"creator" : {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "张三"
},
"custom_fields" : [ {
"name" : "customField16",
"value" : "多选框",
"new_name" : "custom_field16"
} ],
"new_custom_fields" : [ {
"custom_field" : "custom_field16",
"field_name" : "field_name",
"value" : "多选框1,多选框2"
} ],
"developer" : {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "张三"
},
"domain" : {
"id" : 14,
"name" : "性能"
},
"done_ratio" : 0,
"end_time" : "2020-09-19",
"expected_work_hours" : 9,
"id" : 4567,
"project" : {
"project_id" : "526cefde62004de2b62b5e8dd2c2b3af",
"project_name" : "testDemo",
"project_num_id" : 78953
},
"iteration" : {
"id" : 456,
"name" : "迭代1"
},
"module" : {
"id" : 456,
"name" : "Project"
},
"name" : "国际化整改",
"parent_issue" : {
"id" : 123,
"name" : "提供查询项目成员的功能"
},
"priority" : {
"id" : 1,
"name" : "低"
},
"severity" : {
"id" : 12,
"name" : "一般"
},
"status" : {
"id" : 1,
"name" : "新建"
},
"tracker" : {
"id" : 7,
"name" : "story"
},
"updated_time" : "2020-09-14 14:40:11",
"closed_time" : "2020-09-15 14:40:11"
} ],
"total" : 1
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
错误码
请参见错误码。