# 이벤트, 워크플로우 및 안정적인 실행

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

> Markdown version of https://kanorio.com/ko/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는 이벤트를 기록하고 안정적으로 전달합니다. 장시간 실행되는 작업이나 외부 작업은 추적 가능한 작업(Operations)으로 실행되므로 완료 여부를 확인할 수 있습니다.

## 핵심 객체

- **Webhook 엔드포인트**：사용자의 URL, 구독할 이벤트, 선택적 필터입니다. 전달되는 데이터에는 서명이 포함되며 재시도가 지원됩니다.
- **작업(Operations)**：결제나 액세스 권한 부여와 같은 비즈니스 작업으로, 실행 중에 ID를 통해 조회할 수 있습니다.
- **잡(Jobs)**：사이트 생성과 같은 백그라운드 작업으로, 상태를 폴링(polling)하여 확인할 수 있습니다.

## API 활용 방법

- Management API를 사용하여 엔드포인트를 관리하고, 최근 전달 내역을 확인하며, 테스트 이벤트를 전송할 수 있습니다.
- `GET /operations/{id}` 및 `GET /jobs/{id}`를 통해 진행 상황을 보고합니다.
- 서명, 재시도, 캐싱에 대한 자세한 내용은 [Webhooks](https://kanorio.com/ko/developers/webhooks)를, 안전한 재시도를 위한 내용은 [Idempotency](https://kanorio.com/ko/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/ko/help/webhooks