获取子工作项
功能介绍
获取子工作项
调用方法
请参见如何调用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值获取。 约束限制: 可以为空。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
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 |
错误码
请参见错误码。

