- 概述
- 全局错误码
- 鉴权
- 全局
- 产品管理 Product
- 项目管理 Project
- 项目
- Scrum
- Kanban
- 瀑布
- 工作项
- 创建一个工作项POST
- 部分更新一个工作项PATCH
- 批量部分更新一个工作项属性PATCH
- 获取工作项列表GET
- - 获取一个工作项GET
- 删除一个工作项DELETE
- 获取工作项类型列表GET
- - 获取一个工作项类型GET
- 获取工作项状态列表GET
- - 获取一个工作项状态GET
- 获取工作项属性列表GET
- - 获取一个工作项属性GET
- 获取工作项优先级列表GET
- - 获取一个工作项优先级GET
- 获取工作项标签列表GET
- - 获取工作项一个标签GET
- 向工作项中添加一个标签POST
- 在工作项移除一个标签DELETE
- 获取工作项关联类型列表GET
- 关联一个工作项POST
- 获取关联的工作项列表GET
- 取消关联一个工作项DELETE
- 获取工作项流转记录列表GET
- 创建一个工作项交付目标POST
- 部分更新一个工作项交付目标PATCH
- 获取工作项交付目标列表GET
- - 获取工作项一个交付目标GET
- 删除一个工作项交付目标DELETE
- 创建一个工作项
- 发布
- 项目配置中心
- 项目配置
- 工作项配置
- 创建一个工作项标签
- 部分更新一个工作项标签
- 获取全部工作项标签列表
- 删除一个工作项标签
- 创建一个工作项类型
- 部分更新一个工作项类型
- 获取全部工作项类型列表
- 删除一个工作项类型
- 获取工作项类型方案列表
- 向工作项类型方案中添加一个工作项类型
- 部分更新工作项类型方案中的工作项类型
- 获取工作项类型方案中的工作项类型列表
- 在工作项类型方案中移除一个工作项类型
- 创建一个工作项状态
- 部分更新一个工作项状态
- 获取全部工作项状态列表
- 获取工作项状态方案列表
- 向状态方案中添加一个工作项状态
- 获取状态方案中的工作项状态列表
- 在状态方案中移除一个工作项状态
- 向状态方案中添加一个工作项状态流转
- 获取状态方案中的工作项状态流转列表
- 在状态方案中移除一个工作项状态流转
- 创建一个工作项属性
- 部分更新一个工作项属性
- - 获取一个工作项属性
- 获取全部工作项属性列表
- 获取工作项属性方案列表
- 向属性方案中添加一个工作项属性
- 获取属性方案中的工作项属性列表
- 在属性方案中移除一个工作项属性
- 开启工作项本地配置
- 测试管理 Testhub
- 知识管理 Wiki
- DevOps 数据集成
获取工作项列表
GET
https://open.pingcode.com/v1/project/work_items
最后修改时间：2025-10-23 06:31:17
责任人：未设置
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Query 参数
请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open.pingcode.com/v1/project/work_items' \
--header 'Authorization: Bearer <token>'返回响应
🟢200成功
application/json
Body
示例
{
"page_size": 30,
"page_index": 0,
"total": 4,
"values": [
{
"id": "5edca524cad2fa112b06305c",
"url": "https://rest_api_root/v1/project/work_items/5edca524cad2fa112b06305c",
"project": {
"id": "5eb623f6a70571487ea47000",
"url": "https://rest_api_root/v1/project/projects/5eb623f6a70571487ea47000",
"identifier": "SCR",
"name": "Scrum项目",
"type": "scrum"
},
"identifier": "SCR-1",
"title": "这是一个史诗",
"type": "epic",
"start_at": 1583290309,
"end_at": 1583290347,
"assignee": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"state": {
"id": "5c9b35de90ad7153c2062f18",
"url": "https://rest_api_root/v1/project/states/5c9b35de90ad7153c2062f18",
"name": "新建",
"type": "pending",
"color": "#ff7575"
},
"priority": {
"id": "5eb623f6a70571487ea47111",
"url": "https://rest_api_root/v1/project/priorities/5eb623f6a70571487ea47111",
"name": "最高"
},
"description": "这是一个史诗的描述",
"completed_at": 1583290347,
"properties": {
"prop_a": "prop_a_value",
"prop_b": "prop_b_value",
"risk": null,
"business_value": null,
"effort": 123,
"backlog_from": null
},
"tags": [
{
"id": "5e6b35de50ef8153c2062f70",
"url": "https://rest_api_root/v1/project/tags/5e6b35de50ef8153c2062f70",
"name": "标签-1"
}
],
"participants": [
{
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/project/work_items/5edca524cad2fa112b06305c/participants/a0417f68e846aae315c85d24643678a9",
"type": "user",
"user": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
}
}
],
"created_at": 1583290300,
"created_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"updated_at": 1583290300,
"updated_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"is_archived": 0,
"is_deleted": 0
},
{
"id": "5edfa3b67463c1ee626c0979",
"url": "https://rest_api_root/v1/project/work_items/5edfa3b67463c1ee626c0979",
"project": {
"id": "5eb623f6a70571487ea47000",
"url": "https://rest_api_root/v1/project/projects/5eb623f6a70571487ea47000",
"identifier": "SCR",
"name": "Scrum项目",
"type": "scrum"
},
"identifier": "SCR-2",
"title": "这是一个特性",
"type": "feature",
"start_at": 1583290309,
"end_at": 1583290347,
"parent_id": "5edca524cad2fa112b06305c",
"parent": {
"id": "5edca524cad2fa112b06305c",
"url": "https://rest_api_root/v1/project/work_items/5edca524cad2fa112b06305c",
"identifier": "SCR-1",
"title": "这是一个史诗",
"type": "epic",
"start_at": 1583290309,
"end_at": 1583290347
},
"assignee": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"version": {
"id": "5eb623487ea47001f6a70571",
"url": "https://rest_api_root/v1/project/projects/5eb623f6a70571487ea47000/versions/5eb623487ea47001f6a70571",
"name": "1.0.1",
"start_at": 1565255712,
"end_at": 1565255879,
"stage": {
"id": "5f44a8f8bb347b14b49624a1",
"url": "https://rest_api_root/v1/project/stages/5f44a8f8bb347b14b49624a1",
"name": "未开始",
"type": "pending",
"color": "#FA8888"
}
},
"state": {
"id": "5c9b35de90ad7153c2062f18",
"url": "https://rest_api_root/v1/project/states/5c9b35de90ad7153c2062f18",
"name": "新建",
"type": "pending",
"color": "#ff7575"
},
"priority": {
"id": "5eb623f6a70571487ea47111",
"url": "https://rest_api_root/v1/project/priorities/5eb623f6a70571487ea47111",
"name": "最高"
},
"description": "这是一个特性的描述",
"completed_at": 1583290347,
"properties": {
"prop_a": "prop_a_value",
"prop_b": "prop_b_value",
"risk": null,
"business_value": null,
"effort": null,
"backlog_type": null,
"backlog_from": null
},
"tags": [
{
"id": "5e6b35de50ef8153c2062f70",
"url": "https://rest_api_root/v1/project/tags/5e6b35de50ef8153c2062f70",
"name": "标签-1"
}
],
"participants": [
{
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/project/work_items/5edfa3b67463c1ee626c0979/participants/a0417f68e846aae315c85d24643678a9",
"user": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
}
}
],
"created_at": 1583290300,
"created_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"updated_at": 1583290300,
"updated_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"is_archived": 1,
"is_deleted": 1
},
{
"id": "5edca112b06305c524cad2fa",
"url": "https://rest_api_root/v1/project/work_items/5edca112b06305c524cad2fa",
"project": {
"id": "5eb623f6a70571487ea47000",
"url": "https://rest_api_root/v1/project/projects/5eb623f6a70571487ea47000",
"identifier": "SCR",
"name": "Scrum项目",
"type": "scrum"
},
"identifier": "SCR-3",
"title": "这是一个用户故事",
"type": "story",
"start_at": 1583290309,
"end_at": 1583290347,
"parent_id": "5edfa3b67463c1ee626c0979",
"parent": {
"id": "5edfa3b67463c1ee626c0979",
"url": "https://rest_api_root/v1/project/work_items/5edfa3b67463c1ee626c0979",
"identifier": "SCR-2",
"title": "这是一个特性",
"type": "feature",
"start_at": 1583290309,
"end_at": 1583290347,
"parent_id": "5edca524cad2fa112b06305g"
},
"assignee": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"version": {
"id": "5eb623487ea47001f6a70571",
"url": "https://rest_api_root/v1/project/projects/5eb623f6a70571487ea47000/versions/5eb623487ea47001f6a70571",
"name": "1.0.1",
"start_at": 1565255712,
"end_at": 1565255879,
"stage": {
"id": "5f44a8f8bb347b14b49624a1",
"url": "https://rest_api_root/v1/project/stages/5f44a8f8bb347b14b49624a1",
"name": "未开始",
"type": "pending",
"color": "#FA8888"
}
},
"sprint": {
"id": "5ecf7b74eaab845a2aa53138",
"url": "https://rest_api_root/v1/project/projects/5eb623f6a70571487ea47000/sprints/5ecf7b74eaab845a2aa53138",
"name": "Sprint 1",
"start_at": 1589791860,
"end_at": 1589791860,
"status": "completed"
},
"state": {
"id": "5c9b35de90ad7153c2062f18",
"url": "https://rest_api_root/v1/project/states/5c9b35de90ad7153c2062f18",
"name": "新建",
"type": "pending",
"color": "#ff7575"
},
"priority": {
"id": "5eb623f6a70571487ea47111",
"url": "https://rest_api_root/v1/project/priorities/5eb623f6a70571487ea47111",
"name": "最高"
},
"description": "这是一个用户故事的描述",
"completed_at": 1583290347,
"properties": {
"prop_a": "prop_a_value",
"prop_b": "prop_b_value",
"risk": null,
"backlog_type": null,
"backlog_from": null
},
"tags": [
{
"id": "5e6b35de50ef8153c2062f70",
"url": "https://rest_api_root/v1/project/tags/5e6b35de50ef8153c2062f70",
"name": "标签-1"
}
],
"participants": [
{
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/project/work_items/5edca112b06305c524cad2fa/participants/a0417f68e846aae315c85d24643678a9",
"type": "user",
"user": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
}
}
],
"created_at": 1583290300,
"created_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"updated_at": 1583290300,
"updated_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"is_archived": 0,
"is_deleted": 0
},
{
"id": "5edca5d2fa112b06305c24ca",
"url": "https://rest_api_root/v1/project/work_items/5edca5d2fa112b06305c24ca",
"project": {
"id": "6375cc81e3004de4ea14aa52",
"url": "http://rest_api_root/v1/project/projects/6375cc81e3004de4ea14aa52",
"identifier": "WTF",
"name": "瀑布项目",
"type": "waterfall"
},
"identifier": "WTF-2",
"title": "这是一个瀑布项目下需求类型的工作项",
"type": "630da48bc9443b1aa94ce3ea",
"start_at": 1583290309,
"end_at": 1583290347,
"assignee": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"state": {
"id": "5c9b35de90ad7153c2062f18",
"url": "https://rest_api_root/v1/project/states/5c9b35de90ad7153c2062f18",
"name": "新建",
"type": "pending",
"color": "#ff7575"
},
"priority": {
"id": "5eb623f6a70571487ea47111",
"url": "https://rest_api_root/v1/project/priorities/5eb623f6a70571487ea47111",
"name": "最高"
},
"phase": {
"id": "63761fee31caaf77189816b4",
"url": "http://rest_api_root/v1/project/projects/63761fee31caaf7718981698/phases/63761fee31caaf77189816b4",
"title": "这是一个阶段",
"identifier": "WTF-1"
},
"description": "这是一个瀑布项目下需求类型的工作项描述",
"completed_at": 1583290347,
"story_points": 1,
"properties": {
"prop_a": "prop_a_value",
"prop_b": "prop_b_value",
"backlog_type": null,
"backlog_from": null,
"phase": null
},
"tags": [
{
"id": "5e6b35de50ef8153c2062f70",
"url": "https://rest_api_root/v1/project/tags/5e6b35de50ef8153c2062f70",
"name": "标签-1"
}
],
"participants": [
{
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/project/work_items/5edca112b06305c524cad2fa/participants/a0417f68e846aae315c85d24643678a9",
"type": "user",
"user": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
}
}
],
"created_at": 1583290300,
"created_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"updated_at": 1583290300,
"updated_by": {
"id": "a0417f68e846aae315c85d24643678a9",
"url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
"name": "john",
"display_name": "John",
"avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
},
"is_archived": 0,
"is_deleted": 0
}
]
}修改于 2025-10-23 06:31:17