SỰ KIỆN API

Webhook, phân phối và chống phát lại

Sự kiện được ký, quản trị phiên bản và phân phối ít nhất một lần. Bên nhận phải xác minh, loại trùng và xác nhận mà không chỉ tin vào transport.

Phong bì sự kiện

{
  "eventId": "evt_...",
  "eventType": "signing_request.completed",
  "occurredAt": "2026-07-19T10:00:00Z",
  "resourceId": "sr_...",
  "tenantId": "tenant_...",
  "data": { "evidenceReceiptId": "evr_..." }
}

Hợp đồng phân phối

Control	Behavior
Signature	HMAC or asymmetric signature with key ID/version
Freshness	Timestamp tolerance and replay cache
Delivery	At-least-once
Retry	Exponential backoff with maximum retention
Ordering	Not globally guaranteed; resource version included
Deduplication	eventId is stable across retries
Failure queue	Visible to authorized operator with redelivery action

Loại sự kiện khuyến nghị

signing_request.awaiting_approval, signing_request.approved, signing_request.completed, signing_request.failed, asic_package.completed, verification.completed, evidence.renewal_due and provider.health_changed.