文档首页/ 需求管理 CodeArts Req/ API参考/ API/ Scrum项目的规划/ 查询项目下当前用户拥有的所有规划
更新时间：2025-10-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询项目下当前用户拥有的所有规划

功能介绍

查询项目下当前用户拥有的所有规划。

调用方法

请参见如何调用API。

URI

POST /v3/plan/{project_id}/{plan_id}/issues

表1 路径参数

参数

是否必选

参数类型

描述

plan_id

是

String

参数解释：

单个规划的id，通过查询项目列表接口获取，响应消息体中的id字段的值就是单个规划的id。

约束限制：

32位的数字和字母组成的字符串。

取值范围：

不涉及。

默认取值：

不涉及。

project_id

是

String

参数解释：

项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。

约束限制：

32位的数字和字母组成的字符串。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

必传。

取值范围：

最小长度：10，最大长度：32768。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

show_type

否

String

参数解释：

工作项结构类型。

约束限制：

不涉及。

取值范围：

list(列表结构)

tree(树形结构)。

默认取值：

不涉及。

subject

否

String

参数解释：

工作项标题。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

pageNo

否

String

参数解释：

分页索引。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

pageSize

否

String

参数解释：

分页大小。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

tracker_id

否

String

参数解释：

工作项类型。

约束限制：

不涉及。

取值范围：

2（任务/Task）

3（缺陷/Bug）

5（Epic）

6（Feature）

7（Story）

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

result

result object

参数解释：

查询项目下当前用户拥有的所有规划的返回结果。

status

String

参数解释：

查询项目下当前用户拥有的所有规划的返回状态。

取值范围：

success：返回成功。

error：返回失败。
表5 result

参数

参数类型

描述

milestone_cur_count

Integer

参数解释：

里程碑计数。

取值范围：

不涉及。

issue_cur_count

Integer

参数解释：

工作项数量。

取值范围：

不涉及。

issues

Array of IssueNew objects

参数解释：

工作项。

issues_count

Integer

参数解释：

工作项数量。

取值范围：

不涉及。
表6 IssueNew

参数

参数类型

描述

updated_on

String

参数解释：

工作项的更新日期。时间戳格式（示例：1839340800000） 。

取值范围：

不涉及。

story_point

StoryPoint object

参数解释：

工作项的故事点。

取值范围：

不涉及。

subject

String

参数解释：

工作项的负责者。

取值范围：

不涉及。

project

Project object

参数解释：

项目。

取值范围：

不涉及。

isParent

Boolean

参数解释：

是否有子工作项。

取值范围：

true（有子工作项）

false（没有子工作项）

done_ratio

Integer

参数解释：

工作项完成度。

取值范围：

不涉及。

findReleaseDev

String

参数解释：

发布人 。

取值范围：

不涉及。

tracker

Tracker object

参数解释：

工作项的类型。

取值范围：

不涉及。

id

Integer

参数解释：

工作项列表id。

取值范围：

不涉及。

start_date

String

参数解释：

工作项的开始日期。时间戳格式（示例：1839340800000）。

取值范围：

不涉及。

assigned_to

assigned_to object

参数解释：

工作项责任人。

取值范围：

不涉及。

status_attribute

StatusAttributeVO object

参数解释：

工作项的状态属性。

取值范围：

不涉及。

severity

Severity object

参数解释：

重要程度。

取值范围：

不涉及。

releaseDev

String

参数解释：

工作项发布版本号。

取值范围：

不涉及。

author

author object

参数解释：

工作项负责人。

取值范围：

不涉及。

module

Object

参数解释：

工作项的模块。

取值范围：

不涉及。

due_date

String

参数解释：

工作项的截止日期，时间戳格式（示例：1839340800000）。

取值范围：

不涉及。

expected_work_hours

Integer

参数解释：

工作项的预计工时(单位：人时)。

取值范围：

不涉及。

priority

Priority object

参数解释：

优先级。

取值范围：

不涉及。

actual_work_hours

Integer

参数解释：

工作项的实际工时（单位：人/时）。

取值范围：

不涉及。

is_watcher

Boolean

参数解释：

是否关注 。

取值范围：

true（是）

false（不是）

deleted

Boolean

参数解释：

是否删除 。

取值范围：

true（是）

false（不是）

fixed_version

Object

参数解释：

问题解决版本。

取值范围：

不涉及。

is_archived

Boolean

参数解释：

是否归档。

取值范围：

true（是）

false（不是）

created_on

String

参数解释：

工作项的创建时间，时间戳格式（示例：1839340800000）。

取值范围：

不涉及。

domain

Object

参数解释：

工作项的领域 。

取值范围：

不涉及。

developer

Object

参数解释：

工作项的开发人员。

取值范围：

不涉及。

closeder

Object

参数解释：

关闭人员。

取值范围：

不涉及。

position

String

参数解释：

工作项在列表的展示位置 。

取值范围：

不涉及。

closed_flag

Integer

参数解释：

关闭标志 。

取值范围：

0（打开）

1（关闭）

assigned_cc_user

String

参数解释：

工作项的抄送人。

取值范围：

不涉及。

custom_value_new

Object

参数解释：

自定义字段。

取值范围：

不涉及。

status

Status object

参数解释：

工作项的状态。

取值范围：

不涉及。
表7 StoryPoint

参数

参数类型

描述

id

Integer

参数解释：

故事点id。

取值范围：

不涉及。

name

String

参数解释：

故事点名称。

取值范围：

不涉及。
表8 Project

参数

参数类型

描述

identifier

String

参数解释：

项目uuid。

取值范围：

不涉及。

name

String

参数解释：

项目名称。

取值范围：

不涉及。

id

Integer

参数解释：

项目数字id。

取值范围：

不涉及。

type

String

参数解释：

项目类型。

取值范围：

scrum。
表9 Tracker

参数

参数类型

描述

name

String

参数解释：

类型名称。

取值范围：

Task。

Bug。

Epic。

Feature。

Story。

id

Integer

参数解释：

类型id。

取值范围：

2（任务/Task）

3（缺陷/Bug）

5（Epic）

6（Feature）

7（Story）
表10 assigned_to

参数

参数类型

描述

firstName

String

参数解释：

用户名。

取值范围：

不涉及。

lastName

String

参数解释：

用户姓名。

取值范围：

不涉及。

identifier

String

参数解释：

用户32位uuid。

取值范围：

不涉及。

image_id

String

参数解释：

用户头像id。

取值范围：

不涉及。

assignedNickName

String

参数解释：

用户昵称。

取值范围：

不涉及。

name

String

参数解释：

用户名。

取值范围：

不涉及。

id

Integer

参数解释：

用户数字id。

取值范围：

不涉及。
表11 StatusAttributeVO

参数

参数类型

描述

id

String

参数解释：

项目id。

取值范围：

不涉及。

name

String

参数解释：

名称。

取值范围：

不涉及。
表12 Severity

参数

参数类型

描述

name

String

参数解释：

工作项的重要程度。

取值范围：

关键

重要

一般

提示

id

Integer

参数解释：

重要程度id。

取值范围：

10 （关键）

11 （重要）

12 （一般）

13 （提示）
表13 author

参数

参数类型

描述

firstName

String

参数解释：

用户名称。

取值范围：

不涉及。

lastName

String

参数解释：

用户姓名。

取值范围：

不涉及。

identifier

String

参数解释：

作者唯一标识。

取值范围：

不涉及。

image_id

String

参数解释：

用户头像id。

取值范围：

不涉及。

authorNickName

String

参数解释：

用户昵称。

取值范围：

不涉及。

name

String

参数解释：

带租户信息的用户名（租户名称_用户名）。

取值范围：

不涉及。

id

Integer

参数解释：

用户id。

取值范围：

不涉及。
表14 Priority

参数

参数类型

描述

name

String

参数解释：

工作项的优先级。

取值范围：

低。

中。

高。

id

Integer

参数解释：

优先级id 。

取值范围：

1（低）

2（中）

3（高）
表15 Status

参数

参数类型

描述

name

String

参数解释：

状态名称

取值范围：

新建

进行中

已解决

测试中

已关闭

已拒绝

id

Integer

参数解释：

状态id。

取值范围：

1（新建）

2（进行中）

3（已解决）

4（测试中）

5（ 已关闭）

6（已拒绝）

请求示例

POST https://v3/plan/381fcca9c056482d92da3e8b9da71db5/c573497c87414e97a29444c0054c1361/issues

{
  "show_type" : "tree",
  "subject" : "",
  "pageNo" : "1",
  "pageSize" : "50",
  "tracker_id" : "5,6,7,2,3"
}

响应示例

状态码：200

查询项目下当前用户拥有的所有规划接口成功的响应。

{
  "result" : {
    "milestone_cur_count" : 0,
    "issue_cur_count" : 3,
    "issues" : [ {
      "updated_on" : "1753694302000",
      "story_point" : {
        "id" : 3,
        "name" : "1"
      },
      "subject" : "创建工作项",
      "project" : {
        "identifier" : "381fcca9c056482d92da3e8b9da71db5",
        "name" : "DevOps全流程示例项目xxxx",
        "id" : 13222601
      },
      "done_ratio" : 0,
      "findReleaseDev" : "",
      "tracker" : {
        "name" : "Story",
        "id" : 7
      },
      "id" : 69824075,
      "releaseDev" : "",
      "start_date" : "1753632000000",
      "assigned_to" : {
        "firstName" : "hw_008618814464665_01",
        "lastName" : "hw19145027",
        "assignedNickName" : "asdf4",
        "name" : "hw19145027",
        "id" : 233087
      },
      "status_attribute" : { },
      "severity" : {
        "name" : "一般",
        "id" : 12
      },
      "isParent" : false,
      "author" : {
        "firstName" : "hw_008618814464665_01",
        "lastName" : "hw19145027",
        "name" : "hw19145027",
        "id" : 233087,
        "authorNickName" : "asdf4"
      },
      "module" : { },
      "due_date" : "1753718400000",
      "expected_work_hours" : 0,
      "priority" : {
        "name" : "中",
        "id" : 2
      },
      "actual_work_hours" : 0,
      "is_watcher" : false,
      "deleted" : false,
      "fixed_version" : { },
      "is_archived" : false,
      "created_on" : "1753694027000",
      "domain" : { },
      "developer" : { },
      "closeder" : { },
      "position" : "69824075.0000000000",
      "closed_flag" : 0,
      "assigned_cc_user" : [ ],
      "status" : {
        "name" : "新建",
        "id" : 1
      }
    }, {
      "updated_on" : "1753694254000",
      "subject" : "维尔额",
      "project" : {
        "identifier" : "381fcca9c056482d92da3e8b9da71db5",
        "name" : "DevOps全流程示例项目xxxx",
        "id" : 13222601
      },
      "done_ratio" : 0,
      "findReleaseDev" : "",
      "tracker" : {
        "name" : "Epic",
        "id" : 5
      },
      "id" : 69824084,
      "releaseDev" : "",
      "start_date" : "1753632000000",
      "assigned_to" : {
        "firstName" : "hw_008618814464665_01",
        "lastName" : "hw19145027",
        "assignedNickName" : "asdf4",
        "name" : "hw19145027",
        "id" : 233087
      },
      "status_attribute" : { },
      "severity" : {
        "name" : "一般",
        "id" : 12
      },
      "isParent" : false,
      "author" : {
        "firstName" : "hw_008618814464665_01",
        "lastName" : "hw19145027",
        "name" : "hw19145027",
        "id" : 233087,
        "authorNickName" : "asdf4"
      },
      "module" : { },
      "due_date" : "1753718400000",
      "expected_work_hours" : 0,
      "priority" : {
        "name" : "中",
        "id" : 2
      },
      "actual_work_hours" : 0,
      "is_watcher" : false,
      "deleted" : false,
      "fixed_version" : { },
      "is_archived" : false,
      "created_on" : "1753694253000",
      "domain" : { },
      "developer" : { },
      "closeder" : { },
      "position" : "69824084.0000000000",
      "closed_flag" : 0,
      "assigned_cc_user" : [ ],
      "status" : {
        "name" : "新建",
        "id" : 1
      }
    }, {
      "updated_on" : "1753772348000",
      "story_point" : {
        "id" : 3,
        "name" : "1"
      },
      "subject" : "上传图片测试",
      "project" : {
        "identifier" : "381fcca9c056482d92da3e8b9da71db5",
        "name" : "DevOps全流程示例项目xxxx",
        "id" : 13222601
      },
      "done_ratio" : 0,
      "findReleaseDev" : "",
      "tracker" : {
        "name" : "Story",
        "id" : 7
      },
      "id" : 69824415,
      "releaseDev" : "",
      "start_date" : "1753718400000",
      "assigned_to" : {
        "firstName" : "hw_008618814464665_01",
        "lastName" : "hw19145027",
        "assignedNickName" : "asdf4",
        "name" : "hw19145027",
        "id" : 233087
      },
      "status_attribute" : { },
      "severity" : {
        "name" : "一般",
        "id" : 12
      },
      "isParent" : false,
      "author" : {
        "firstName" : "hw_008618814464665_01",
        "lastName" : "hw19145027",
        "name" : "hw19145027",
        "id" : 233087,
        "authorNickName" : "asdf4"
      },
      "module" : { },
      "due_date" : "1753804800000",
      "expected_work_hours" : 0,
      "priority" : {
        "name" : "中",
        "id" : 2
      },
      "actual_work_hours" : 0,
      "is_watcher" : false,
      "deleted" : false,
      "fixed_version" : {
        "name" : "到时发个的覆盖",
        "id" : 21723480
      },
      "is_archived" : false,
      "created_on" : "1753240629000",
      "domain" : { },
      "developer" : { },
      "closeder" : { },
      "position" : "69805475.0000000000",
      "closed_flag" : 0,
      "assigned_cc_user" : [ ],
      "status" : {
        "name" : "新建",
        "id" : 1
      }
    } ],
    "issues_count" : 3
  },
  "status" : "success"
}

状态码

状态码

描述

200

查询项目下当前用户拥有的所有规划接口成功的响应。

错误码

请参见错误码。

父主题： Scrum项目的规划

相关文档