비즈니스 시스템
콘텐츠 및 게시
컬렉션, 블로그 게시물, 페이지 및 사이트 전체 탐색 기능. 초안, 검토, 예약 게시 및 리다이렉트를 지원합니다.
콘텐츠는 사이트가 게시하는 모든 것을 의미합니다. 사용자가 정의한 구조화된 컬렉션, 블로그, 섹션으로 구성된 페이지, 그리고 모든 페이지에서 공유되는 헤더, 푸터 및 설정이 포함됩니다. 동일한 콘텐츠가 Kanorio에서 호스팅되는 사이트와 직접 구축한 프론트엔드 모두에서 사용됩니다.
핵심 객체
- 컬렉션 및 아이템：텍스트, 리치 텍스트, 숫자, 날짜, 미디어 및 다른 컬렉션에 대한 참조와 같은 컬렉션의 필드를 정의하며, 아이템에 데이터를 저장합니다. 컬렉션은 특정 필드에 대한 접근을 멤버나 구매자로 제한할 수 있습니다.
- 게시물：블로그는 게시물, 카테고리, 태그, 작성자라는 내장 컬렉션 세트로 구성됩니다. 게시물은 게시 전 검토 및 예약 게시 기능을 지원합니다.
- 페이지 및 섹션：각 페이지는 유형이 지정된 섹션의 순서가 있는 목록입니다. 호스팅된 사이트는 이를 렌더링하며, 헤드리스 프론트엔드는 동일한 데이터를 읽어옵니다.
- 글로벌：헤더, 푸터 및 사이트 설정(예: CTA 버튼 및 소셜 링크).
- 리다이렉트 및 리비전：페이지 이름을 변경하면 자동으로 리다이렉트가 생성되며, 이전 버전의 콘텐츠를 복원할 수 있습니다.
- 가져오기：이미지, 카테고리 및 원래 작성일을 유지하면서 다른 플랫폼에서 게시물을 가져올 수 있습니다.
API 활용 방법
- Management API를 사용하여 데이터를 작성합니다. 페이지, 글로벌 및 게시물에 대한 작성 내용은 게시 작업이 실행되기 전까지 초안 상태로 유지됩니다. 컬렉션 아이템은 초안을 요청하지 않는 한 즉시 게시됩니다.
- Content Delivery API를 사용하여 게시된 콘텐츠를 읽어옵니다. 이 API는 익명이며 엣지 캐시가 적용되어 브라우저에서 안전하게 사용할 수 있습니다. 모든 응답에서 미디어는 하나의
assets맵으로 해결됩니다. collections.item.*,content.page.*및content.translation.*웹훅을 수신합니다. 웹훅에 포함된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
사이트 운영자용
관리 화면에서 이 제품을 사용하는 방법은 도움말 센터에서 안내합니다.
도움말 센터 열기