# 事件、工作流与可靠执行

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

> Markdown version of https://kanorio.com/zh-CN/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 端点。** 您的 URL、它们订阅的事件以及可选的过滤器。发送内容均经过签名并支持重试。
- **操作。** 业务操作（例如付款或访问授权），具有您可以在运行期间查询的 ID。
- **任务。** 后台工作（例如生成网站），具有您可以轮询的状态。

## API 如何运作

- 使用 Management API 管理端点、列出最近的发送记录并发送测试事件。
- `GET /operations/{id}` 和 `GET /jobs/{id}` 可报告进度。
- 请参阅 [Webhooks](https://kanorio.com/zh-CN/developers/webhooks) 以了解签名、重试和缓存机制，并参阅 [Idempotency](https://kanorio.com/zh-CN/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-CN/help/webhooks