雲端基礎設施
發佈傳遞、探索與測量
邊緣快取的 Content Delivery API、網站搜尋、SEO 與 AI 檔案、邊緣重新導向、第一方分析與自訂網域。
傳遞是指已發佈的內容如何觸及訪客、搜尋引擎與 AI 助理,無論是由 Kanorio 託管網站,還是您自行建置前端。
涵蓋範圍
- Content Delivery API: 匿名、邊緣快取讀取,支援版本權杖與快取標籤。發佈後,網站會在數秒內切換至新版本。
- 搜尋: 跨頁面、文章與產品的全文搜尋。
- SEO 與 AI 檔案: Sitemap、robots.txt、llms.txt、Feed 與 JSON-LD,連結皆指向您的網域。
- 邊緣規則: 重新導向、AI 爬蟲封鎖與 IndexNow 權杖檔案,透過您中間件中的
@kanorio/sdk/edge應用。 - 分析: 第一方頁面瀏覽量與 AI 助理引薦來源,由
<kanorio-analytics>回報。 - 網域: 自訂網域及其 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 參考
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
給網站擁有者
在後台如何使用這項產品,請見說明中心。
開啟說明中心