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 サーバーの記事が、より高レベルの連携を扱っています。