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

Kiểm soát	Hành vi
Chữ ký	Chữ ký HMAC hoặc bất đối xứng kèm key ID/version
Độ mới	Dung sai timestamp và replay cache
Phân phối	At-least-once
Retry	Exponential backoff với thời gian lưu tối đa
Thứ tự	Không đảm bảo thứ tự toàn cục; có kèm resource version
Khử trùng lặp	eventId ổn định qua các lần retry
Hàng đợi lỗi	Hiển thị cho operator được ủy quyền kèm hành động redeliver

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.