开放 API

PRO 及以上会员可以用访问令牌调用 Insighto 的 REST API，把写笔记这件事接进你自己的脚本、快捷指令或自动化流程里——一条 curl 就能记一条笔记。

第一步：获取访问令牌

API 用访问令牌（Access Token）认证，在设置里生成：

1. 打开「设置 → 访问令牌」。
2. 点「创建密钥」，填一个描述（方便你日后分辨这个令牌用在哪），选有效期（默认 30 天，也可选永不过期）。
3. 创建后立即复制——令牌只会完整显示这一次，关闭后无法再次查看。
4. 把令牌妥善保存在你的脚本或密钥管理工具里。

第二步：带上令牌认证

所有请求都通过 HTTP 头带上令牌，API 域名为 api.insighto.com.cn：

Authorization: Bearer <你的访问令牌>

创建一条笔记

向 /api/v1/memos 发一个 POST，请求体就是笔记本身，content 是正文，visibility 目前仅支持 PRIVATE（私有）：

curl -X POST https://api.insighto.com.cn/api/v1/memos \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"想到就记 #insighto","visibility":"PRIVATE"}'

获取笔记列表

用 GET 拉取自己的笔记：

curl https://api.insighto.com.cn/api/v1/memos \
  -H "Authorization: Bearer $TOKEN"

常用端点

下面这些覆盖了绝大多数集成场景。路径里的 {id} 换成具体笔记 ID（列表接口返回的 name 形如 memos/123）：

请求参数

请求体与查询参数都用 JSON 惯用的驼峰命名（如 pageSize、orderBy）。

笔记字段（创建 / 更新的请求体）

列表查询参数（GET /api/v1/memos）

响应里 memos 是本页笔记数组，nextPageToken 非空时把它作为下一次请求的 pageToken 继续翻页。

附件字段（POST /api/v1/attachments）

评论（POST /api/v1/memos/{id}/comments）

请求体 comment 就是一条笔记，字段同上（content、visibility）——评论本质上是挂在目标笔记下的一条笔记。

更新示例

更新用 PATCH，并通过 updateMask 指明要改哪些字段（否则未列出的字段可能被清空），例如只改正文：

curl -X PATCH "https://api.insighto.com.cn/api/v1/memos/123?updateMask=content" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"改过的正文"}'