/api/block/deleteBlock

删除块

方法: POST

认证: Token (通过 Authorization 头或者 Cookie _xsrf 传递)

接口描述

该接口用于删除指定 ID 的块。如果删除的是文档块，其关联的文件也会被放入回收站。

参数

参数 类型 位置 必需 描述 默认值
id string Body (JSON) 是 要删除的块的 ID。 -

响应

状态码 描述 响应体
200 OK 成功 
{
    "code": 0,
    "msg": "",
    "data": {
        "transactions": [
            {
                "doOperations": [
                    {
                        "action": "delete",
                        "id": "块ID"
                        // 其他操作相关的字段...
                    }
                ],
                // 其他事务相关的字段...
            }
        ]
    }
}
400 Bad Request 请求错误（如 ID 无效或块不存在） 
{
    "code": -1,
    "msg": "Invalid block ID pattern [...] 或 Block not found [...]",
    "data": null
}

示例

请求体 (JSON)

{
    "id": "20230517100000-abcdefgh"
}

在线测试

此 API 通过请求体传递参数。