# 说明

返回符合查询条件的所有看板工作项（分页显示，默认一页30条）

# SDK 方法名

nodeJs:

方法名::

getBoardCards

# url

https://api.tapd.cn/board_cards

# 支持格式

JSON/XML（默认JSON格式）

# HTTP请求方式

GET

# 请求数限制

默认返回 30 条。可通过传 limit 参数设置，最大取 200。也可以传 page 参数翻页

# 请求参数

字段名	必选	类型及范围	说明	特殊规则
workspace_id	是	integer	项目ID
id	否	integer	工作项ID	支持多ID查询
b_board_id	否	integer	看板ID
b_column_id	否	integer	板块ID
owner	否	string	负责人
cc	否	string	参与人
status	否	string	状态
name	否	string	工作项标题
created	否	datetime	创建时间	支持时间查询
begin	否	datetime	开始时间	支持时间查询
due	否	datetime	截止时间	支持时间查询
b_label	否	integer	标签ID
limit	否	integer	设置返回数量限制，默认为30
page	否	integer	返回当前数量限制下第N页的数据，默认为1（第一页）
fields	否	string	设置获取的字段，多个字段间以','逗号隔开

# 调用示例及返回结果

curl -u 'api_user:api_password' 'https://api.tapd.cn/board_cards?workspace_id=20355782'

# 返回结果

{
	status: 1,
	data: [
	    {
			BoardCard: {
				id: "1020355782500624163",
				name: "('测试2')",
				description: "546546541davsavddv按房产税大V是",
				created: "2019-09-11 14:39:45",
				modified: "2019-09-11 14:42:41",
				workspace_id: "20355782",
				owner: "null;",
				due: "2019-09-19",
				b_label: "[0]",
				b_sort: "2",
				b_board_id: "1020355782000010725",
				b_column_id: "1020355782000045509",
				status: "open",
				cc: "null",
				begin: "2019-09-11"
			}
		}
	],
	info: "success"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 看板工作项字段说明

# 看板工作项重要字段说明

字段	说明
workspace_id	项目ID
id	工作项ID
b_board_id	看板ID
b_column_id	板块ID
description	详细描述
owner	负责人
cc	参与人
status	状态
name	工作项标题
created	创建时间
modified	最后修改时间
begin	开始时间
due	截止时间
b_label	标签ID

← 新建看板工作项更新看板工作项 →