getTailChildBlocks
POST /api/block/getTailChildBlocks
获取指定父块末尾指定数量的子块信息。
这常用于在大文档或长列表中,只加载最后一部分内容以提高性能。
鉴权:需要认证 Token。
请求体参数
参数 | 类型 | 描述 |
---|---|---|
id |
string |
必需。目标父块的 ID。 |
n |
integer |
可选。要获取的末尾子块的数量。如果省略或小于 1,默认为 7。 |
返回值
成功时返回包含末尾子块信息的对象数组:
{
"code": 0,
"msg": "",
"data": [
{
"id": "末尾子块ID_N-k+1",
"type": "块类型",
"content": "内容摘要",
// ... 其他块信息
},
// ... 最多 n 个块
{
"id": "末尾子块ID_N",
"type": "块类型",
"content": "内容摘要",
// ...
}
]
}
如果父块不存在或没有子块,`data` 字段会是一个空数组 `[]`。
失败时(例如 ID 格式无效):
{
"code": -1, // 或其他错误码
"msg": "错误信息",
"data": null
}
请求示例
获取 ID 为 `20230101...` 的块末尾 5 个子块的信息:
{
"id": "20230101120000-abcdefgh",
"n": 5
}
获取 ID 为 `20230101...` 的块末尾默认数量(7个)的子块信息:
{
"id": "20230101120000-abcdefgh"
}
在线测试
服务器地址:
API Token:
API 路径:
请求方法:
请求体:
响应结果:
查看源代码 (block.go) | 查看模型代码 (model/block.go) | 返回 Block API 列表 | 返回 API 首页