转移块引用 API (`/api/block/transferBlockRef`)

接口描述

该接口用于将所有对源块(`fromID`)的引用转移到目标块(`toID`)。

执行后,所有原来引用 `fromID` 的块将改为引用 `toID`。原来引用 `toID` 的块保持不变。

`swapBlockRef` 不同,这是一个单向的引用转移。

请求

方法: POST

路径: `/api/block/transferBlockRef`

认证: 需要 Token

请求体 (JSON)

参数 类型 必需 描述
`fromID` string 源块的 ID,即被替换引用的块。
`toID` string 目标块的 ID,即新的引用目标。

请求示例

{
    "fromID": "20230517100000-abcdefgh",
    "toID": "20230517100000-ijklmnop"
}

响应

成功响应 (200 OK)

成功转移引用后,返回一个空数据对象。

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

失败响应

如果请求失败(例如,ID 无效或块不存在),将返回错误信息。

{
    "code": -1,
    "msg": "Invalid block ID pattern [无效的ID]", // 或 "Block not found [id=...]"
    "data": null
}

在线测试

测试结果:

注意:这是一个社区维护的文档,可能与官方最新版本存在差异。

如果您觉得本文档有帮助,可以考虑赞助支持:爱发电