API 文件

Caliu 各個 App 所做的一切，都經由位於 https://api.caliuapp.com 的公開 REST API：筆記、標籤、提醒、附件、搜尋、同步、分享和匯出。App 做得到的事，你的程式碼也做得到。

互動式文件

在互動式參考文件中瀏覽每一個端點、結構描述和範例請求：

• api.caliuapp.com/docs，直接由 API 提供
• caliuapp.com/docs，同一份參考文件，嵌在 Caliu 網站上

兩者都能讓你查看請求和回應的結構，並直接從瀏覽器試著發出呼叫。App 裡的 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 伺服器那篇文章介紹了層次更高的整合方式。