Skip to content

端点

/api/block/getHeadingChildrenIDs

getHeadingChildrenIDs

getHeadingChildrenIDs

POST /api/block/getHeadingChildrenIDs

获取指定标题块下的所有直接子块的 ID 列表。

这个接口只返回直接子块的 ID,不会递归查询更深层级的子块。

鉴权:需要认证 Token。

请求体参数

参数类型描述
idstring必需。目标标题块的 ID。

返回值

成功时返回包含子块 ID 的字符串数组:

json
{
    "code": 0,
    "msg": "",
    "data": [
        "子块ID_1",
        "子块ID_2",
        // ...
    ]
}

如果标题块不存在或没有子块,`data` 字段会是一个空数组 `[]`。

失败时(例如 ID 格式无效):

json
{
    "code": -1, // 或其他错误码
    "msg": "错误信息",
    "data": null
}

请求示例

获取 ID 为 `20230101...` 的标题块的子块 ID:

json
{
    "id": "20230101120000-abcdefgh"
}

在线测试

服务器地址:

API Token:

API 路径:

请求方法:

请求体:

发送请求

响应结果:

查看源代码 (block.go) | 查看模型代码 (model/block.go) | 返回 Block API 列表 | 返回 API 首页

© 2024 Siyuan Note API Documentation