Caliu 各应用所做的一切都经由位于 https://api.caliuapp.com 的公开 REST API:笔记、标签、提醒、附件、搜索、同步、分享和导出。应用能做的任何事,你的代码也能做。
交互式文档
在交互式参考中浏览每一个端点、模式和示例请求:
- api.caliuapp.com/docs,直接由 API 提供
- caliuapp.com/docs,同一份参考,嵌入在 Caliu 网站上
两者都能让你探索请求和响应的结构,并在浏览器里试着发起调用。应用里的 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 服务器一文介绍了一种更高层的集成方式。