云端基础设施
发布传递、探索与测量
边缘缓存的 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
给网站所有者
如何在后台使用这项产品,请参阅帮助中心。
打开帮助中心