先选择接口
集成请求都应发往应用实例地址。这个文档网站只提供静态参考,不会代理你的凭据。根据数据流方向,选择最简单的合适接口。
先建立只读连接
通过自己的私密凭据管理方式设置应用地址 MEMOS_URL 和令牌 MEMOS_TOKEN。下面的请求读取当前账号,不会创建令牌或修改记录。允许写入前,确认返回的是预期账号。非本地连接应使用 HTTPS。
curl --fail-with-body \
-H "Authorization: Bearer $MEMOS_TOKEN" \
"$MEMOS_URL/api/v1/auth/me"验证完整边界
使用合成笔记测试集成。检查一次允许的读取、一次应被拒绝的读取;如需写入,再测试一个可撤回且能在应用中核对结果的修改。令牌只用于认证账号,不会让所有资源都可写。启用 AI 或 Webhook 前,应明确哪些笔记或文件内容会离开实例,以及接收方是谁。
设计重试与撤销
分页读取时保留并继续使用分页令牌,直到列表完整。写入后超时,应先核对资源再重试;即使响应丢失,服务端也可能已经完成操作。事件接收端应能处理重复投递。令牌与 Webhook 密钥不要进入日志,不再需要集成时撤销访问。