API 密钥

API 密钥让脚本、集成和 AI 智能体能够通过位于 https://api.caliuapp.com 的 REST API,与你的 Caliu 账户通信。

创建密钥

  • 在网页应用中: 打开侧边栏底部的用户菜单,选择 API 密钥,然后 新建 API 密钥。给它起一个能让你知道用途的名字(比如"我的脚本")。
  • 在 iPhone 与 iPad 应用以及 Mac 应用中: 打开设置,然后账户,然后 API 密钥

每个密钥都以 caliu_ 开头。请立即复制它:出于安全考虑,Caliu 只存储你密钥的哈希值,因此它只会显示一次。之后列表里只显示一小段前缀,以及每个密钥的创建时间和最后使用时间。

使用它

把密钥作为 Bearer 令牌放在 Authorization 请求头里发送:

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

完整的 API 范围记录在交互式文档中。请看 API 文档一文。

吊销密钥

在你创建密钥的同一界面吊销任意密钥。吊销是即时的:任何仍在使用该密钥的应用会在下一次请求时失去访问权限。把密钥当作密码来对待,永远不要把它们提交进代码。