# 事件、工作流程與可靠執行

> Signed webhooks with retries and filters, trackable operations and background jobs.

> Markdown version of https://kanorio.com/zh-HK/developers/products/events. 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/events.md

Status: **Available**

當網站出現變更時，Kanorio 會記錄事件並可靠地傳送。長時間執行與外部工作會以追蹤操作的形式執行，讓您可以查看其是否已完成。

## 核心物件

- **Webhook 端點。** 您的網址、它們訂閱的事件以及選用的篩選器。傳送內容皆經過簽章並支援重試。
- **操作。** 業務操作（例如付款或存取授權），具有您可以在執行期間查詢的 ID。
- **工作。** 背景工作（例如產生網站），具有您可以輪詢的狀態。

## API 如何運作

- 使用 Management API 管理端點、列出最近的傳送紀錄並傳送測試事件。
- `GET /operations/{id}` 與 `GET /jobs/{id}` 可回報進度。
- 請參閱 [Webhooks](https://kanorio.com/zh-HK/developers/webhooks) 以了解簽章、重試與快取機制，並參閱 [Idempotency](https://kanorio.com/zh-HK/developers/basics/idempotency) 以了解安全重試。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Signed webhooks, per-event filters & ISR cache tags | Available | Management API `webhooks.*` (`filter.collectionKeys`, `filter.formIds`); SDK `parseDeliveryCacheTags` | — | `/settings/webhooks` | All `TEAM_SUBSCRIBABLE_EVENT_KEYS` (HMAC-SHA256 signed, automatic retries) |

## API reference

- Management API: [Operations](https://kanorio.com/en/developers/management-api/operations) (1 operations)
- Management API: [Jobs](https://kanorio.com/en/developers/management-api/jobs) (1 operations)
- Management API: [Webhooks](https://kanorio.com/en/developers/management-api/webhooks) (5 operations)

## Recent changes

- 2026-11-03: Cache tags: per-record and per-locale invalidation, new localization events
- 2026-10-27: BUSY (503) admission errors
- 2026-10-27: operations.get, Idempotency-Key, optimistic concurrency on pages.update

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

## For site owners

Dashboard help: https://kanorio.com/zh-HK/help/webhooks