# 發佈傳遞、探索與測量

> The edge-cached Content Delivery API, site search, SEO and AI files, edge redirects, first-party analytics and custom domains.

> Markdown version of https://kanorio.com/zh-Hant/developers/products/delivery. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/delivery.md

Status: **Partial**

傳遞是指已發佈的內容如何觸及訪客、搜尋引擎與 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 會回報分析里程碑以及外部前端的問題。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Full-text site search | Available | Delivery `GET /search`; Management API `site.search` | — | Hosted site search box | — |
| Site speed & Core Web Vitals monitor (`/seo/speed`) | Available | — | — | `/seo/speed` (CrUX field data & PageSpeed Insights lab data) | — |
| On-site promotional widgets (`/marketing/on-site/topbar`, modal, floating buttons) | Hosted only | — | — | `/marketing/on-site/topbar`, `/marketing/on-site/modal`, `/marketing/on-site/floating` (injected into Kanorio-hosted DOM; hidden in backoffice when `frontendMode` is `HEADLESS`) | — |
| Brand identity: logo, site icon, brand colors, color scheme, fonts & corner radius (`/settings/brand`) | Available | Management `site.get_settings` / `site.update_settings` (`settings.brand`); Delivery `GET /site` (`brand`: colors resolved per color scheme with readable foreground, the owner's `colorScheme`, logo per backdrop, font families with stylesheet URLs, corner radius scale); CLI `settings update --brand-color --corner-radius --color-scheme` | `KanorioProvider` and every element read `brand` from `GET /site` once and apply it to `.kanorio-elements` as `--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 (`/editor` design surface) | Hosted only | — | — | `/editor` visual site builder (hidden in backoffice when `frontendMode` is `HEADLESS`) | — |
| Automatic OG image generation, `sitemap.xml`, `robots.txt` & JSON-LD output | Available | Delivery `GET /seo/sitemap.xml`, `GET /seo/robots.txt`, `GET /seo/indexnow-key.txt`, `GET /seo/jsonld?path=`, plus `seo` object on `/pages/:slug` and `/collections/blog/items/:slug` (`ogImage` includes `autoOgImage`); SDK `seo.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 | Available | 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.txt` and edge bot tracker | — |
| First-party visitor & AI crawler traffic analytics (`/analytics`) | Partial | Delivery `POST /analytics/pageview` (anonymous, per-IP rate-limited, records `path` / `referrer` / UA category); Management API `analytics.*` | `<KanorioAnalytics />` | `/analytics` | — |

## API reference

- Management API: [Site](https://kanorio.com/en/developers/management-api/site) (13 operations)
- Management API: [Domains](https://kanorio.com/en/developers/management-api/domains) (3 operations)
- Management API: [Analytics](https://kanorio.com/en/developers/management-api/analytics) (4 operations)
- Management API: [Seo](https://kanorio.com/en/developers/management-api/seo) (2 operations)
- Content Delivery API: [Openapi](https://kanorio.com/en/developers/delivery-api/openapi) (1 operations)
- Content Delivery API: [Site](https://kanorio.com/en/developers/delivery-api/site) (1 operations)
- Content Delivery API: [Seo](https://kanorio.com/en/developers/delivery-api/seo) (6 operations)
- Content Delivery API: [Analytics](https://kanorio.com/en/developers/delivery-api/analytics) (2 operations)
- Content Delivery API: [Search](https://kanorio.com/en/developers/delivery-api/search) (1 operations)

## Webhook events

- `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).

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-analytics>`: Privacy-first pageview and SPA route-change tracking sent with a non-blocking beacon.

## Recent changes

- 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

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/zh-Hant/help/seo