精简与完整双端点
/api/search 默认 compact,/api/detail 默认 full;两个端点共享稳定的 HTTP 契约。
Milanote API 面向需要读取公开共享画板的原型、内部工具和数据管道。它将上游未公开且可能变化的结构,转换为版本化的 MilanoteDocument,再按需生成更小的 JSON 投影。
| 需求 | 端点 |
|---|---|
| 列表、索引或搜索结果 | GET /api/search,默认 compact |
| 完整画板与 Canvas | GET /api/detail,默认 full |
| 自定义字段 | 任一端点配合 view、include 或 exclude |
从旧版迁移
旧版 /api/search 的完整响应行为已迁移到 /api/detail。/api/search 现在默认返回精简字段; 需要完整 MilanoteDocument 的调用方必须改用 /api/detail。
上游兼容性
Milanote 的 /api/boards 不是公开 API。项目会宽容读取未知字段,但上游仍可能随时发生破坏性变化。