说明

新建看板工作项，返回新建看板工作项的数据

SDK 方法名

nodeJs:

SDK使用方式 (opens new window)

插件中使用SDK

方法名::

addBoardCard

url

https://api.tapd.cn/board_cards

支持格式

JSON/XML（默认JSON格式）

HTTP请求方式

POST

请求数限制

一次插入一条数据

请求参数

字段名	必选	类型及范围	说明
workspace_id	是	integer	项目ID
b_board_id	是	integer	看板ID
b_column_id	是	integer	板块ID
name	是	string	工作项标题
owner	否	string	负责人
cc	否	string	参与人
status	否	string	状态
begin	否	datetime	开始时间
due	否	datetime	截止时间
b_label	否	integer	标签ID
description	否	string	详细描述

调用示例及返回结果

curl -u 'api_user:api_password' -d 'workspace_id=20355782&name=test1&b_column_id=1020355782000045509&b_board_id=1020355782000010725' 'https://api.tapd.cn/board_cards'

返回结果

{
	status: 1,
	data: [
	    {
			BoardCard: {
				"id":"1020355782500624255",
				"name":"test1",
				"description":null,
				"created":"2019-09-17 15:58:43",
				"modified":"2019-09-17 15:58:43",
				"workspace_id":"20355782",
				"owner":null,
				"due":null,
				"b_label":"[0]",
				"b_sort":"3",
				"b_board_id":"1020355782000010725",
				"b_column_id":"1020355782000045509",
				"status":"open",
				"cc":null,
				"begin":null
			}
		}
	],
	info: "success"
}

看板工作项字段说明

看板工作项重要字段说明

字段	说明
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