API 金鑰

API 金鑰讓指令碼、整合服務和 AI 代理程式,能透過位於 https://api.caliuapp.com 的 REST API 與你的 Caliu 帳號溝通。

建立金鑰

  • 在網頁版中: 開啟側邊欄底部的使用者選單,選擇 API 金鑰,然後選新增 API 金鑰。取一個能讓你一眼看出用途的名字(例如「我的指令碼」)。
  • 在 iPhone 和 iPad App 以及 Mac App 中: 開啟設定,然後選帳號,再選 API 金鑰

每一組金鑰都以 caliu_ 開頭。請立刻複製它:基於安全考量,Caliu 只儲存金鑰的雜湊值,所以它只會顯示這麼一次。之後清單裡只會看到一小段前綴,以及每組金鑰的建立時間和最後使用時間。

怎麼使用

把金鑰當成 Bearer 權杖,放在 Authorization 請求標頭裡送出:

curl https://api.caliuapp.com/notes \
  -H "Authorization: Bearer caliu_your_key_here"

完整的 API 介面都記錄在互動式文件裡。請看 API 文件那篇文章。

撤銷金鑰

在建立金鑰的同一個畫面,就可以撤銷任何一組金鑰。撤銷是立即生效的:任何還在使用那組金鑰的應用程式,會在下一次請求時失去存取權限。把金鑰當成密碼看待,絕對不要把它們提交到程式碼裡。