클라우드 인프라
게시, 전달, 검색 및 측정
에지 캐시된 Content Delivery API, 사이트 검색, SEO 및 AI 파일, 에지 리디렉션, 퍼스트 파티 분석 및 사용자 지정 도메인에 대해 알아봅니다.
전달(Delivery)은 Kanorio가 사이트를 호스팅하든 사용자가 직접 프론트엔드를 구축하든 관계없이, 게시된 콘텐츠가 방문자, 검색 엔진 및 AI 어시스턴트에게 도달하는 방식을 의미합니다.
주요 기능
- Content Delivery API. 버전 키와 캐시 태그를 사용하는 익명화된 에지 캐시 읽기 기능입니다. 게시를 수행하면 몇 초 이내에 사이트가 새 버전으로 전환됩니다.
- 검색. 페이지, 게시물 및 제품 전체에 대한 전체 텍스트 검색을 지원합니다.
- SEO 및 AI 파일. 사용자 도메인을 가리키는 링크가 포함된 사이트맵, robots.txt, llms.txt, 피드 및 JSON-LD를 제공합니다.
- 에지 규칙. 미들웨어의
@kanorio/sdk/edge를 통해 적용되는 리디렉션, AI 크롤러 차단 및 IndexNow 키 파일 설정입니다. - 분석.
<kanorio-analytics>를 통해 보고되는 퍼스트 파티 페이지 뷰 및 AI 어시스턴트 유입 경로를 측정합니다. - 도메인. 사용자 지정 도메인 및 해당 DNS 상태를 관리합니다.
API 활용 방법
- Management API를 사용하여 사이트 게시 및 게시 취소, 개발자 설정 변경, 미리보기 토큰 생성, 도메인 바인딩 및 분석 쿼리를 수행할 수 있습니다.
- 이 페이지에 설명된 나머지 모든 기능은 Content Delivery API 및 SDK를 통해 제공됩니다.
- Webhooks는 분석 마일스톤 및 외부 프론트엔드와 관련된 문제를 보고합니다.
API로 제공되는 범위
- Full-text site search사용 가능
- API
- Delivery
GET /search; Management APIsite.search - 호스팅 사이트
- Hosted site search box
- Site speed & Core Web Vitals monitor (
/seo/speed)사용 가능- 호스팅 사이트
/seo/speed(CrUX field data & PageSpeed Insights lab data)
- On-site promotional widgets (
/marketing/on-site/topbar, modal, floating buttons)호스팅 전용- 호스팅 사이트
/marketing/on-site/topbar,/marketing/on-site/modal,/marketing/on-site/floating(injected into Kanorio-hosted DOM; hidden in backoffice whenfrontendModeisHEADLESS)- 대안
- Model announcements as a custom Collection in
/dataand render your own banner or modal component in your frontend.
- Brand identity: logo, site icon, brand colors, color scheme, fonts & corner radius (
/settings/brand)사용 가능- API
- Management
site.get_settings/site.update_settings(settings.brand); DeliveryGET /site(brand: colors resolved per color scheme with readable foreground, the owner'scolorScheme, logo per backdrop, font families with stylesheet URLs, corner radius scale); CLIsettings update --brand-color --corner-radius --color-scheme - Elements
KanorioProviderand every element readbrandfromGET /siteonce and apply it to.kanorio-elementsas--brand-color,--brand-foreground,--site-radius-*and the brand font (brand={false}to opt out)- 호스팅 사이트
/settings/brand(both frontend modes; takes effect immediately, no publish)
- Section layout & theme: text sizes & section density (
/editordesign surface)호스팅 전용- 호스팅 사이트
/editorvisual site builder (hidden in backoffice whenfrontendModeisHEADLESS)- 대안
- Page content (
sections[]), headers, footer andseometadata are exposed via Delivery API/pagesand/globals/*, and brand identity viaGET /sitebrand; visual layout is owned by your frontend codebase.
- Automatic OG image generation,
sitemap.xml,robots.txt& JSON-LD output사용 가능- API
- Delivery
GET /seo/sitemap.xml,GET /seo/robots.txt,GET /seo/indexnow-key.txt,GET /seo/jsonld?path=, plusseoobject on/pages/:slugand/collections/blog/items/:slug(ogImageincludesautoOgImage); SDKseo.rewrites({ framework }),seo.jsonLd(path),createKanorioMiddleware()(serves the IndexNow key file) - 호스팅 사이트
- Automatically served on Kanorio-hosted pages
llms.txt,llms-full.txt& AI crawler management사용 가능- API
- Delivery
GET /seo/llms.txt,GET /seo/llms-full.txt,GET /seo/robots.txt,GET /site(crawlerRules),POST /analytics/bot-hit; SDK@kanorio/sdk/edge(createKanorioMiddleware) - 호스팅 사이트
- Hosted
/llms.txt,/llms-full.txtand edge bot tracker
- First-party visitor & AI crawler traffic analytics (
/analytics)일부- API
- Delivery
POST /analytics/pageview(anonymous, per-IP rate-limited, recordspath/referrer/ UA category); Management APIanalytics.* - Elements
<KanorioAnalytics />- 호스팅 사이트
/analytics
API 레퍼런스
- SiteManagement API · 엔드포인트 13개
- DomainsManagement API · 엔드포인트 3개
- AnalyticsManagement API · 엔드포인트 4개
- SeoManagement API · 엔드포인트 2개
- OpenapiContent Delivery API · 엔드포인트 1개
- SiteContent Delivery API · 엔드포인트 1개
- SeoContent Delivery API · 엔드포인트 6개
- AnalyticsContent Delivery API · 엔드포인트 2개
- SearchContent Delivery API · 엔드포인트 1개
Webhook 이벤트
- site.analytics.milestone · Fired when cumulative site pageviews reach a milestone.
- site.externalFrontend.degraded · Fired when the daily external frontend health check detects failing core endpoints (unreachable storefront or broken SEO rewrites).
Elements
- <kanorio-analytics> · Privacy-first pageview and SPA route-change tracking sent with a non-blocking beacon.
최근 변경
- 2026-11-04 Localization: each locale can have its own URL slug
- 2026-11-03 SDK: locale routing, hreflang alternates and wildcard redirects at the edge
- 2026-11-03 Cache tags: per-record and per-locale invalidation, new localization events
- 2026-11-03 Delivery API: locale on every read
- 2026-11-03 Developer settings: headlessEnabled removed
사이트 운영자용
관리 화면에서 이 제품을 사용하는 방법은 도움말 센터에서 안내합니다.
도움말 센터 열기