跳至主要内容

PUT /cards/{id}/move

描述​

移动卡片到指定位置

此路由处理发送到 cards/{id}/move 端点的 HTTP PUT 请求。

路径参数​

请求 URL 中应包含以下参数:

名称类型描述
idnumber必填。要移动的卡片的 ID。若移动多个卡片，id 需设置为 0。
信息

如果要移动多个卡片，id 必须设置为 0；否则，如果使用其他值，则仅移动具有该特定 id 的卡片。

请求负载​

服务器期望接收一个包含以下属性的 JSON 对象:

名称类型描述
idnumber必填。正在移动的卡片的 ID。
columnIdnumber必填。卡片所在列的 ID。
rowIdnumber必填。卡片所在行的 ID。
beforenumber可选。移动的卡片应放置在其之前的卡片 ID。
batchobject多选时必填。一个包含被移动卡片对象的数组。

示例:

{
    "id": 4,
    "columnId": 2,
    "rowId": 1,
    "before": "7"
}

当移动多个卡片时，batch 属性应包含所有被移动卡片对象的数组:

{
    "batch": [
        {
            "id": 2,
            "columnId": 1,
            "rowId": 1,
            "before": "1"
        },
        {
            "id": 7,
            "columnId": 1,
            "rowId": 1,
            "before": "1"
        }
    ]
}

响应​

服务器返回一个 JSON 对象，包含卡片 ID（单个卡片移动时），或在移动多个卡片时 ID 设置为 0。

示例:

单个卡片操作请求的响应
{
    "id": 4
}
多个卡片操作请求的响应
{
    "id": 0
}

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

相关文章: 与服务器交互