文档首页/需求管理 CodeArts Req/API参考/API/Scrum项目的规划/查询当前规划可添加的工作项列表 - ListPlanByCondition
更新时间：2026-02-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询当前规划可添加的工作项列表 - ListPlanByCondition

功能介绍

查询当前规划可添加的工作项列表。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

POST /v3/plan/{project_id}/{plan_id}/addable-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参数

参数

是否必选

参数类型

描述

subject

否

String

参数解释：

查询工作项列表的筛选条件。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

page_no

否

String

参数解释：

分页索引。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

page_size

否

String

参数解释：

分页大小。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

result

result object

参数解释：

返回结果。

status

String

参数解释：

返回状态。

取值范围：

success：返回成功。

error：返回失败。

表5 result

参数

参数类型

描述

total_count

Integer

参数解释：

工作项总数。

取值范围：

不涉及。

issue_cur_count

Integer

参数解释：

当前工作项数量。

取值范围：

不涉及。

issues

Array of Issue objects

参数解释：

工作项。

表6 Issue

参数

参数类型

描述

updated_on

String

参数解释：

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

取值范围：

不涉及。

story_point

StoryPoint object

参数解释：

工作项的故事点。

取值范围：

不涉及。

subject

String

参数解释：

工作项的负责者。

取值范围：

不涉及。

project

Project object

参数解释：

项目。

取值范围：

不涉及。

is_parent

Boolean

参数解释：

是否有子工作项。

取值范围：

true（有子工作项）

false（没有子工作项）

done_ratio

Integer

参数解释：

工作项完成度。

取值范围：

不涉及。

findReleaseDev

String

参数解释：

发布人 。

取值范围：

不涉及。

tracker

Tracker object

参数解释：

工作项的类型。

取值范围：

不涉及。

id

Integer

参数解释：

工作项列表id。

取值范围：

不涉及。

start_date

String

参数解释：

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

取值范围：

不涉及。

assigned_to

IssueAssignedVO object

参数解释：

工作项责任人。

取值范围：

不涉及。

status_attribute

Object

参数解释：

工作项的状态属性。

取值范围：

不涉及。

severity

Severity object

参数解释：

重要程度。

取值范围：

不涉及。

releaseDev

String

参数解释：

工作项发布版本号。

取值范围：

不涉及。

author

IssueAuthorVO 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 IssueAssignedVO

参数

参数类型

描述

first_name

String

参数解释：

用户名。

取值范围：

不涉及。

last_name

String

参数解释：

用户姓名。

取值范围：

不涉及。

identifier

String

参数解释：

用户32位uuid。

取值范围：

不涉及。

image_id

String

参数解释：

用户头像id。

取值范围：

不涉及。

assigned_nick_name

String

参数解释：

用户昵称。

取值范围：

不涉及。

name

String

参数解释：

用户名。

取值范围：

不涉及。

id

Integer

参数解释：

用户数字id。

取值范围：

不涉及。

表11 Severity

参数

参数类型

描述

name

String

参数解释：

工作项的重要程度。

取值范围：

关键

重要

一般

提示

id

Integer

参数解释：

重要程度id。

取值范围：

10 （关键）

11 （重要）

12 （一般）

13 （提示）

表12 IssueAuthorVO

参数

参数类型

描述

first_name

String

参数解释：

用户名称。

取值范围：

不涉及。

last_name

String

参数解释：

用户姓名。

取值范围：

不涉及。

identifier

String

参数解释：

作者唯一标识。

取值范围：

不涉及。

image_id

String

参数解释：

用户头像id。

取值范围：

不涉及。

assigned_nick_name

String

参数解释：

用户昵称。

取值范围：

不涉及。

name

String

参数解释：

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

取值范围：

不涉及。

id

Integer

参数解释：

用户id。

取值范围：

不涉及。

表13 Priority

参数

参数类型

描述

name

String

参数解释：

工作项的优先级。

取值范围：

低。

中。

高。

id

Integer

参数解释：

优先级id 。

取值范围：

1（低）

2（中）

3（高）

表14 Status

参数

参数类型

描述

name

String

参数解释：

状态名称

取值范围：

新建

进行中

已解决

测试中

已关闭

已拒绝

id

Integer

参数解释：

状态id。

取值范围：

1（新建）

2（进行中）

3（已解决）

4（测试中）

5（ 已关闭）

6（已拒绝）

请求示例

POST https://{endpoint}/v3/plan/381fcca9c056482d92da3e8b9da71db5/c573497c87414e97a29444c0054c1361/addable-issues

{
  "subject" : "",
  "page_no" : "1",
  "page_size" : "15"
}

响应示例

状态码：200

查询当前规划可添加的工作项列表接口成功的响应。

{
  "result" : {
    "total_count" : 321,
    "issue_cur_count" : 0,
    "issues" : [ {
      "updated_on" : "1753695191000",
      "subject" : "又一个工作项",
      "project" : {
        "identifier" : "c15cc54e338d4506afd9bd8103071ff0",
        "name" : "Scrum0610ceshi",
        "id" : 34883337
      },
      "done_ratio" : 0,
      "tracker" : {
        "name" : "Epic",
        "id" : 5
      },
      "id" : 9191004,
      "start_date" : "1753660800000",
      "assigned_to" : {
        "assigned_nick_name" : "张三丰1",
        "name" : "devcloud_devcloud_s00404480_01",
        "last_name" : "devcloud_devcloud_s00404480_01",
        "id" : 4091,
        "image_id" : "photo01.png",
        "first_name" : "devcloud_devcloud_s00404480_01"
      },
      "status_attribute" : { },
      "severity" : {
        "name" : "一般",
        "id" : 12
      },
      "author" : {
        "name" : "devcloud_devcloud_s00404480_01",
        "last_name" : "devcloud_devcloud_s00404480_01",
        "id" : 4091,
        "image_id" : "photo01.png",
        "first_name" : "devcloud_devcloud_s00404480_01"
      },
      "module" : { },
      "due_date" : "1753747200000",
      "expected_work_hours" : 0,
      "priority" : {
        "name" : "中",
        "id" : 2
      },
      "actual_work_hours" : 0,
      "is_watcher" : false,
      "deleted" : false,
      "fixed_version" : { },
      "is_archived" : false,
      "created_on" : "1753695183000",
      "domain" : { },
      "developer" : { },
      "closeder" : { },
      "position" : "9191004.0000000000",
      "closed_flag" : 0,
      "assigned_cc_user" : [ ],
      "custom_value_new" : { },
      "status" : {
        "name" : "新建",
        "id" : 1
      }
    }, {
      "updated_on" : "1752465766000",
      "subject" : "工作项",
      "project" : {
        "identifier" : "c15cc54e338d4506afd9bd8103071ff0",
        "name" : "Scrum0610ceshi",
        "id" : 34883337
      },
      "done_ratio" : 0,
      "tracker" : {
        "name" : "Epic",
        "id" : 5
      },
      "id" : 9168625,
      "start_date" : "1752451200000",
      "assigned_to" : {
        "assigned_nick_name" : "张三丰1",
        "name" : "devcloud_devcloud_s00404480_01",
        "last_name" : "devcloud_devcloud_s00404480_01",
        "id" : 4091,
        "image_id" : "photo01.png",
        "first_name" : "devcloud_devcloud_s00404480_01"
      },
      "status_attribute" : { },
      "severity" : {
        "name" : "一般",
        "id" : 12
      },
      "author" : {
        "name" : "devcloud_devcloud_s00404480_01",
        "last_name" : "devcloud_devcloud_s00404480_01",
        "id" : 4091,
        "image_id" : "photo01.png",
        "first_name" : "devcloud_devcloud_s00404480_01"
      },
      "module" : { },
      "due_date" : "1752537600000",
      "expected_work_hours" : 0,
      "priority" : {
        "name" : "中",
        "id" : 2
      },
      "actual_work_hours" : 0,
      "is_watcher" : false,
      "deleted" : false,
      "fixed_version" : { },
      "is_archived" : false,
      "created_on" : "1752465765000",
      "domain" : { },
      "developer" : { },
      "closeder" : { },
      "position" : "9168625.0000000000",
      "closed_flag" : 0,
      "assigned_cc_user" : [ ],
      "custom_value_new" : { },
      "status" : {
        "name" : "新建",
        "id" : 1
      }
    } ]
  },
  "status" : "success"
}

状态码

状态码

描述

200

查询当前规划可添加的工作项列表接口成功的响应。

错误码

请参见错误码。

相关文档