Content Delivery APIは、外部フロントエンドやモバイルアプリ向けに設計された公開HTTP APIであり、お客様のウェブサイト独自のドメイン直下にマウントされます。コレクション、ブログ、ページ、またはオンラインフォームでコンテンツを公開すると、あらゆるフロントエンドフレームワーク(Next.js、Astro、Remix、Nuxt、SvelteKitなど)から直接呼び出すことが可能です。フロントエンドにAPIキーを保存する必要はなく、グローバルエッジキャッシュによりミリ秒単位の応答速度を実現します。
エンドポイント、パラメータ、エラーコードの全容(SSOT): すべてのエンドポイントパス、クエリパラメータ、レスポンス構造、レート制限ヘッダー、およびエラーコードは、OpenAPI 3.1仕様から自動生成され、Content Delivery APIリファレンスページで確認できます(
https://{your-site}/api/v1/openapi.jsonをサイトから直接ダウンロードすることも可能です)。本記事では、プラットフォームレベルの設計コンセプトに焦点を当てます。
| 比較 | コンテンツ配信 API(本ガイド) | 顧客 API(購入者) | 管理 REST API / MCP |
|---|---|---|---|
| ベース URL | https://{your-website}/api/v1 | https://{your-website}/api/v1/customer | https://app.kanorio.com/api/v1 |
| 認証が必要ですか? | いいえ(公開/匿名。ドラフトプレビュー時のみトークンが必要) | 購入者のログイン後に Bearer セッション(knr_cat_)が必要 | はい(Authorization: Bearer knr_pat_... が必要) |
| ブラウザで安全に使用できますか? | はい(CORS 許可オリジン設定時) | はい(ログインした購入者に限定) | いいえ(サーバーサイド、CI、または AI ツールのみ) |
| データバージョン | 公開データのみを返します | 購入者向けのリアルタイムアクセスと進捗 | ドラフトおよび公開データの読み取り/書き込みアクセス |
| ドキュメント | 配信 API リファレンス |
ウェブサイトには、Content Delivery APIを呼び出すための2種類のURLが存在します。
https://s-xxxxxxxxxxxx.kanorio.com/api/v1): 作成時に割り当てられる永続的なURLです。Kanorioホスト型のページを公開していない場合([| 顧客 API リファレンス |
| 管理 API リファレンス |