ビジネスシステム
コンテンツと公開
コレクション、ブログ投稿、ページ、サイト全体のナビゲーション機能。下書き、レビュー、予約公開、リダイレクトに対応しています。
コンテンツとは、サイトが公開するすべての情報を指します。独自の構造化コレクション、ブログ、セクションで構築されたページ、そしてすべてのページで共有されるヘッダー、フッター、設定などが含まれます。同一のコンテンツが、Kanorioでホストされるサイトと、構築したあらゆるフロントエンドの両方で利用可能です。
コアオブジェクト
- コレクションとアイテム:テキスト、リッチテキスト、数値、日付、メディア、他のコレクションへの参照など、コレクションのフィールドを定義し、アイテムにデータを保持します。コレクションでは、フィールドへのアクセスをメンバーや購入者に制限できます。
- 投稿:ブログは、投稿、カテゴリ、タグ、作成者という組み込みコレクションのセットです。投稿は、公開前のレビューや予約公開に対応しています。
- ページとセクション:各ページは、型指定されたセクションの順序付きリストです。ホストされたサイトはこれらをレンダリングし、ヘッドレスフロントエンドは同じデータを読み取ります。
- グローバル:ヘッダー、フッター、サイト設定(CTAボタンやSNSリンクなど)。
- リダイレクトとリビジョン:ページ名を変更すると自動的にリダイレクトが作成され、以前のコンテンツバージョンを復元できます。
- インポート:画像、カテゴリ、元の投稿日を保持したまま、他のプラットフォームから投稿を移行できます。
APIの活用方法
- Management APIで書き込みを行います。ページ、グローバル、投稿への書き込みは、公開操作が実行されるまで下書き状態となります。コレクションアイテムは、下書きを指定しない限り即座に公開されます。
- Content Delivery APIで公開済みコンテンツを読み取ります。これは匿名でエッジキャッシュされ、ブラウザから安全に利用できます。すべてのレスポンスにおいて、メディアは1つの
assetsマップ内で解決されます。 collections.item.*、content.page.*、content.translation.*のWebhooksをリッスンします。これに含まれるcacheTagsを使用することで、変更されたページとロケールのみを正確に更新できます。
API で利用できる範囲
- Collections (structured content)提供中
- API
- Management API
collections.*(typed fields including references, media andjson; field-levelaccessPolicy),items.*; DeliveryGET /collections/*(filter[f][op],filter[any], relative datesnow-30d,sort,total=false,assetsmap,expandfullfieldData,has_slug/eq_slug,accesssummary &Bearer knr_cat_gating); CLIkanorio types - ホスト型サイト
/dataworkbench; collection list / detail pages- Webhooks
collections.item.*,collections.items.bulkChanged,collections.schema.changed
- Blog (system collections)提供中
- API
- Management API
posts.*,blog_categories.list,blog_tags.list; DeliveryGET /collections/blog/items(?formats=markdown,html,plaintext,segments[],toc[],primary_author,primary_category),GET /feed(RSS 2.0) &GET /feed.atom - ホスト型サイト
/postseditor,/data/blog; hosted/blog,/blog/:slug- Webhooks
collections.item.*
- Pages, globals (header/footer) & redirects提供中
- API
- Management API
pages.*,globals.*,site.publish; DeliveryGET /pages,GET /pages/:slug,GET /globals/headers/:key,GET /globals/footer,GET /redirects - ホスト型サイト
/editorvisual builder- Webhooks
content.page.*,content.site.published(withpreviousSlug&cacheTags)
- Draft preview tokens (
knr_pv_)提供中- API
- Management API
site.create_preview_token; DeliveryX-Kanorio-Preview: knr_pv_...(edge HMAC verified, bypasses cache); SDK@kanorio/sdk/preview(createPreviewRouteHandler,previewHeaders,tokenFromCookieHeader) - ホスト型サイト
/settings/developerpreview token manager;/consolePreview button
- GraphQL API提供なし
- 代替手段
- Kanorio exposes a strongly typed REST + OpenAPI 3.1 Content Delivery API with
?fields=projection, 1-layer?expand=relation resolution, top-levelassetsbatch resolution, andnpx @kanorio/cli typesfor end-to-end TypeScript types without GraphQL schema maintenance.
- Multi-environment / schema branching & content staging environments提供なし
- 代替手段
- Each site uses a double-buffered Draft (
fieldData) and Published (publishedFieldData) model with read-onlyknr_pv_preview tokens for staging verification. If you need a separate sandbox, create a dedicated dev site.
- Scheduled publishing for posts & collection items提供中
- API
posts.publish/items.publishaccept optionalscheduledAt(freezes text content as a revision — posts: title/excerpt/contentMarkdown/showToc, items: fieldData/slug — and publishes that exact snapshot when due; taxonomy, SEO and sortOrder are not frozen);posts.unschedule/items.unscheduleto cancel- ホスト型サイト
/postsand/datapublish button (schedule picker, badge, cancel, "Scheduled" quick filter)
- Batch release packages & multi-step approval workflows (assigned reviewers, comment threads)提供なし
- 代替手段
- Blog posts and collection items support fine-grained custom RBAC roles (
collections:schema,collections:managevs.collections:publish/blog:publish, separating who can edit from who can publish) with 1-click access requests, plus a lightweight single-step review (*.request_review/*.reject_reviewwith one rejection-reason note, no assignment or comment threads). For cross-content batch releases or multi-step approval, orchestrate your own CI/cron on top ofposts.publish/items.publish.
- Per-item revision history, trash, optimistic concurrency & edit/publish separation for custom Collections and blog posts提供中
- API
- Management API
revisions.*(subject: CONTENT_ITEMorBLOG_POST, up to 50 revisions/item, 30-day retention);items.list_archived,items.restore,items.purge;items.update/items.bulk_update/posts.updateacceptifUnmodifiedSinceand returnCONFLICTwith the currentupdatedAtinstead of silently overwriting;collections:publish/blog:publishscopes are separate fromcollections:manage/blog:manage - ホスト型サイト
/dataworkbench record panel (version history tab, trash view, conflict banner);/postsarticle editor (conflict banner)
items.bulk_delete& Import/Export REST API提供なし- 代替手段
- Custom Collections provide draft/published double buffering, backoffice CSV/JSON import & export (
/data), and full-site ZIP backups (collections/*.json).
- Visual click-to-edit overlays (Content Source Maps / stega) on external storefronts提供なし
- 代替手段
- External storefronts use read-only
knr_pv_preview tokens (and?kp=knr_pv_...handoff from the backoffice Preview button) with@kanorio/sdk/previewrather than DOM-injected click-to-edit overlays.
API リファレンス
- SectionsManagement API · 1 件のエンドポイント
- GlobalsManagement API · 7 件のエンドポイント
- PagesManagement API · 7 件のエンドポイント
- PostsManagement API · 9 件のエンドポイント
- ImportsManagement API · 7 件のエンドポイント
- Blog categoriesManagement API · 2 件のエンドポイント
- Blog tagsManagement API · 2 件のエンドポイント
- AuthorsManagement API · 3 件のエンドポイント
- CollectionsManagement API · 5 件のエンドポイント
- ItemsManagement API · 15 件のエンドポイント
- RevisionsManagement API · 3 件のエンドポイント
- RedirectsContent Delivery API · 1 件のエンドポイント
- PagesContent Delivery API · 2 件のエンドポイント
- GlobalsContent Delivery API · 2 件のエンドポイント
- CollectionsContent Delivery API · 1 件のエンドポイント
- ItemsContent Delivery API · 2 件のエンドポイント
- FeedContent Delivery API · 2 件のエンドポイント
Webhook イベント
- collections.item.created · Fired when a collection item is created (includes publicVersion and cacheTags).
- collections.item.updated · Fired when a collection item draft or published payload is updated.
- collections.item.published · Fired when a collection item is published and visible on the Content Delivery API.
- collections.item.unpublished · Fired when a collection item is unpublished and removed from the Content Delivery API.
- collections.item.deleted · Fired when a collection item is permanently deleted.
- collections.items.bulkChanged · Fired once per batch operation (bulkCreate, bulkUpdate, publish/unpublish batch, or CSV/JSON import).
- collections.schema.changed · Fired when a collection or its field schema is created, updated, or deleted (triggers `kanorio types` regeneration).
- content.site.published · Fired when a site is published, invalidating pages, globals, and redirects caches.
- content.page.published · Fired when a page is published on the site.
- content.page.updated · Fired when a published page's content or slug is updated (includes previousSlug when renamed).
- content.page.unpublished · Fired when a page is unpublished or hidden.
- content.page.deleted · Fired when a page is deleted.
ガイド
最近の変更
- 2026-11-04 Localization: publishing one locale needs the record's publish permission
- 2026-11-04 Localization: each locale can have its own URL slug
- 2026-11-03 Site brand identity: one setting for hosted pages, checkout, sign-in, emails and your own front end
- 2026-11-01 Authors and instructors: one shared list for posts and deliverables
- 2026-10-31 Import posts from another site
サイト運営者向け
管理画面での使い方はヘルプセンターで説明しています。
ヘルプセンターを開く