将指定的内容块(可以是 Markdown 或 DOM 字符串)追加到指定笔记本的当日日记文档的末尾。如果当日日记文档不存在,将自动创建。
参数名 | 类型 | 必选 | 描述 |
---|---|---|---|
notebook | string | 是 | 目标笔记本的 ID。 |
data | string | 是 | 要追加的内容块数据。 |
dataType | string | 是 | `data` 参数的数据类型,必须是 `"markdown"` 或 `"dom"`。 |
成功时返回一个包含执行的操作事务的对象数组。
参数名 | 类型 | 描述 |
---|---|---|
code | number | 返回码,0 表示成功,-1 表示失败 |
msg | string | 返回信息,成功时为空 |
data | array (object) | 包含事务信息的数组。每个事务对象包含 `doOperations` 数组,其中描述了具体的操作(如 `appendInsert`)、操作数据和目标父块 ID(日记文档 ID)。 |
POST /api/block/appendDailyNoteBlock
Content-Type: application/json
Authorization: Token your-api-token
{
"notebook": "20200812220555-lj3enxa",
"dataType": "markdown",
"data": "* 这是追加的列表项"
}
POST /api/block/appendDailyNoteBlock
Content-Type: application/json
Authorization: Token your-api-token
{
"notebook": "20200812220555-lj3enxa",
"dataType": "dom",
"data": "<p data-node-id='20240...' data-type='NodeParagraph'>这是追加的段落 DOM</p>"
}
{
"code": 0,
"msg": "",
"data": [
{
"doOperations": [
{
"action": "appendInsert",
"parentID": "20240315103000-abcdef12", // 当日日记文档 ID
"data": "<ul data-node-id='...' ...><li data-node-id='...' ...>这是追加的列表项</li></ul>", // 转换后的 DOM
// 其他操作细节...
}
]
// 其他事务信息...
}
]
}
注意:这是一个社区维护的文档,可能与官方最新版本存在差异。
如果您觉得本文档有帮助,可以考虑赞助支持:爱发电