API · Diarum

基于令牌的只读日记 API、自动生成的 OpenAPI 文档，以及 Memos Webhook 同步，轻松把日记接入你的工作流。

日记 API

在「设置 → API 访问」中开启 API 后会生成一个专属令牌。用它就能在任何地方读取自己的日记：

# 获取某一天的日记
curl "https://diary.example.com/api/v1/diaries?token=<令牌>&date=2026-10-10"

# 获取一段时间内的日记
curl "https://diary.example.com/api/v1/diaries?token=<令牌>&start=2026-10-01&end=2026-10-07"

单日查询返回：

{
  "id": "…",
  "date": "2026-10-10",
  "content": "<h2>秋天的第一次远足</h2><p>…</p>",
  "mood": "😊",
  "weather": "☀️",
  "exists": true
}

范围查询返回 { "diaries": [...], "total": n }。令牌可以随时重置，重置后旧令牌立即失效；也可以直接关闭 API。

自动化示例：n8n 周报

n8n 中新建工作流，用 Schedule Trigger 每周日晚上触发；
HTTP Request 节点调用 /api/v1/diaries?token=…&start=…&end=… 获取本周日记；
交给 AI / LLM 节点生成周报；
通过邮件、Telegram、飞书或企业微信发送给自己。

同样的思路可以做月报、年度总结、每日提醒，或者把日记同步到其他笔记系统。

OpenAPI 文档

每个 Diarum 实例都自带接口文档：

/api/v1/openapi.json：根据当前已注册的路由实时生成的 OpenAPI 规范；
/api/v1/docs：Swagger UI 交互式文档。

Memos 同步

如果你同时在用 Memos 记录碎片想法，可以在「设置 → Memos 同步」中开启同步，获得一个 Webhook 地址并填入 Memos 的 Webhook 设置。

之后在 Memos 中新增、修改、删除 memo，都会自动同步到 memo 创建日期对应的那篇日记里，每条 memo 是独立的区块，并附带回到 Memos 原文的链接。

版本接口

/api/v1/version 返回当前运行的版本号，方便监控与升级检查。