根据ID移动多个文档 (moveDocsByID)

接口描述

本接口用于根据文档ID将多个文档移动到目标位置。与moveDocs接口不同，该接口使用文档ID来指定来源和目标，而不是路径。

移动文档时会保持文档的内容、属性和子文档关系，仅更改文档的位置。

请求参数

请求体为一个 JSON 对象，包含以下字段：

响应体

成功时，响应体为一个 JSON 对象，包含以下字段：

请求示例

{
  "fromIDs": [
    "20200813125239-hbwpz87",
    "20200822191536-rm6hwid"
  ],
  "toID": "20210210102319-m0ql889"
}
            

响应示例

成功响应：

{
  "code": 0,
  "msg": "",
  "data": null
}
            

失败响应（ID不存在）：

{
  "code": -1,
  "msg": "加载文档树失败 id [20210210102319-xxxx]: 文档块不存在",
  "data": {
    "closeTimeout": 7000
  }
}
            

错误码

源码定位

后端实现相关的核心逻辑可以在以下文件中找到：

• 路由定义：siyuan/kernel/api/router.go（路由 /api/filetree/moveDocsByID）
• API 处理函数：siyuan/kernel/api/filetree.go（函数 moveDocsByID）
• 模型层实现：siyuan/kernel/model/file.go（函数 MoveDocs）