API 文档

Caliu 各应用所做的一切都经由位于 https://api.caliuapp.com 的公开 REST API:笔记、标签、提醒、附件、搜索、同步、分享和导出。应用能做的任何事,你的代码也能做。

交互式文档

在交互式参考中浏览每一个端点、模式和示例请求:

两者都能让你探索请求和响应的结构,并在浏览器里试着发起调用。应用里的 API 密钥界面上还有一个查看 API 文档的快捷入口。

OpenAPI 规范

该 API 由一份 OpenAPI 3.1 文档描述,它从提供这些端点的同一份代码生成,因此永远不会与实际情况脱节:

https://api.caliuapp.com/openapi.json

把它喂给代码生成器、Postman 这类 API 客户端,或你自己的工具链。

认证

大多数端点期望以 Bearer 令牌形式发送一个 API 密钥:

Authorization: Bearer caliu_your_key_here

关于如何创建一个,请看 API 密钥一文。如果你是在为 AI 智能体开发,MCP 服务器一文介绍了一种更高层的集成方式。