API キーを使うと、スクリプト、連携、AI エージェントが、https://api.caliuapp.com の REST API を通じて、あなたの Caliu アカウントとやり取りできます。
キーを作成する
- Web アプリ: サイドバー下部のユーザーメニューを開いて API キー を選び、新しい API キー を選びます。何のためのものかがわかる名前（たとえば「My Script」）を付けます。
- iPhone と iPad のアプリ、Mac アプリ: 設定 を開き、アカウント、API キー に進みます。
どのキーも caliu_ で始まります。すぐにコピーしてください。 セキュリティのため、Caliu はキーのハッシュだけを保存するので、キーが表示されるのは一度きりです。一覧にはあとから、短い接頭辞と、各キーの作成日時と最終使用日時だけが表示されます。
使う
キーを Authorization ヘッダーに、Bearer トークンとして送ります:
curl https://api.caliuapp.com/notes \
-H "Authorization: Bearer caliu_your_key_here"
API の全体像は、対話型ドキュメントに記載されています。API ドキュメントの記事をご覧ください。
キーを取り消す
どのキーも、作成したのと同じ画面から取り消せます。取り消しはすぐに反映されます。そのキーをまだ使っているアプリケーションは、次のリクエストでアクセスを失います。キーはパスワードのように扱い、決してコードにコミットしないでください。