跳至主要内容

POST /cards

描述

添加一张新卡片,并返回包含该卡片 ID 的 json 对象。

此端点处理发送到 /cards URL 的 HTTP POST 请求。

请求负载

服务器需要一个包含以下字段的 json 对象:

名称类型描述
labelstring必填。要创建的卡片标题。
columnnumber必填。卡片将被放置的列的 ID。
rownumber必填。卡片将被定位的行的 ID。

示例:

{
"label": "New card",
"column": 2,
"row": 1,
}

响应

该端点返回一个包含新创建卡片 ID 的 json 对象。

示例:

{ 
"id": 1
}

HTTP 状态码指示请求是否成功(response.status == 200)或是否发生错误(response.status == 500)。


相关文档: Working with server