通过 Dinox 开放接口在笔记下创建批注，并了解笔记列表中的子卡字段和过滤规则。

批注（子卡）接口

批注（子卡）是挂在某篇笔记下的一段补充内容。它只有一层，没有自己的标题和卡片盒；读取标签时按「父笔记 ∪ 批注」合并。

基础域名为 https://aisdk.chatgo.pro，接口前缀为 /api/openapi。请求头使用 Authorization: <你的Token>；接口需要可写笔记的 Token。

创建批注

接口地址

POST /api/openapi/notes/children/create

请求参数（application/json）

参数名	类型	必填	说明
parentNoteId	string	是	父笔记 ID；如果传入的是批注 ID，新批注会挂到该批注的父笔记下
content	string	是	Markdown 正文，去除首尾空白后不能为空，最多 100000 字符
tags	string[]	否	标签全路径数组；每个标签都必须已存在
source	string	否	`user`（默认）或 `ai`
clientRequestId	string	否	幂等键；也可在请求头使用 `Idempotency-Key`

请求示例

{
  "parentNoteId": "00000000-0000-4000-8000-000000000001",
  "content": "补充：这段内容来自第二章。",
  "tags": ["读书/想法"],
  "source": "user",
  "clientRequestId": "annotation-20261029-01"
}

响应示例

{
  "code": "000000",
  "msg": "success",
  "data": {
    "noteId": "00000000-0000-4000-8000-000000000003",
    "parentNoteId": "00000000-0000-4000-8000-000000000001",
    "createdAt": "2026-10-29T08:00:00.000Z",
    "updatedAt": "2026-10-29T08:00:00.000Z",
    "version": 1
  }
}

返回的 parentNoteId 是实际父笔记 ID。Token 缺失或无效、tags 里有不存在的标签时返回 code: "000001"；其他参数错误返回 code: "000006"（HTTP 400）；父笔记不存在或已删除时返回 code: "000006"（HTTP 404）。幂等键最多 256 个字符；使用 Idempotency-Key 请求头或 clientRequestId 时，7 天内相同键和相同请求体会返回相同结果；同一键换用不同请求体时返回 code: "000009"（HTTP 409）。创建批注不会更改父笔记的更新时间或版本。

笔记列表中的批注

POST /api/openapi/listNotes 会照常返回批注，并在每条笔记对象中提供 parentNoteId：批注为父笔记 ID，普通笔记为 null。按卡片盒 ID 或名称过滤时，批注跟随父笔记所在的卡片盒；增量同步也会按批注自身的更新时间返回。

列表的请求参数、按卡片盒过滤方式和响应结构见开放接口的笔记列表。

批注（子卡）接口

批注（子卡）接口

创建批注

笔记列表中的批注

On this page