MOBILE-ID · TRUSTED LTANS
Hợp đồng sự kiện AsyncAPI
Hợp đồng sự kiện có phiên bản, bên phát, phạm vi thứ tự và quy tắc giao nhận.
Hợp đồng sự kiện
Kafka mang mã, siêu dữ liệu và tham chiếu. Cơ chế giao ít nhất một lần yêu cầu khử trùng eventId; thứ tự được giới hạn theo aggregateId. Hộp phát gắn giao dịch và hộp nhận giúp tránh xử lý trùng.
| Sự kiện | Bên phát | Phiên bản | Thứ tự |
|---|---|---|---|
| ArchiveRequested | Dịch vụ lưu trữ | 1.0 | aggregateId |
| ArchiveAccepted | Dịch vụ lưu trữ | 1.0 | aggregateId |
| ArchiveRejected | Dịch vụ lưu trữ | 1.0 | aggregateId |
| EvidenceGenerationRequested | Dịch vụ bằng chứng | 1.0 | aggregateId |
| EvidenceGenerated | Dịch vụ bằng chứng | 1.0 | aggregateId |
| EvidenceGenerationFailed | Dịch vụ bằng chứng | 1.0 | aggregateId |
| VerificationRequested | Dịch vụ kiểm chứng | 1.0 | aggregateId |
| VerificationCompleted | Dịch vụ kiểm chứng | 1.0 | aggregateId |
| RenewalDue | Dịch vụ gia hạn | 1.0 | aggregateId |
| RenewalStarted | Dịch vụ gia hạn | 1.0 | aggregateId |
| RenewalCompleted | Dịch vụ gia hạn | 1.0 | aggregateId |
| RenewalFailed | Dịch vụ gia hạn | 1.0 | aggregateId |
| ExportRequested | Dịch vụ lưu trữ | 1.0 | aggregateId |
| ExportCompleted | Dịch vụ lưu trữ | 1.0 | aggregateId |
| TransferStarted | Dịch vụ lưu trữ | 1.0 | aggregateId |
| TransferCompleted | Dịch vụ lưu trữ | 1.0 | aggregateId |
| DispositionRequested | Dịch vụ kho | 1.0 | aggregateId |
| DispositionApproved | Dịch vụ kho | 1.0 | aggregateId |
| DispositionCompleted | Dịch vụ kho | 1.0 | aggregateId |
Phục hồi chuyển sự kiện
Thử lại có giãn thời gian và giới hạn; sau ngưỡng chuyển DLQ. Người có quyền điều tra nguyên nhân, sửa cấu hình, phát lại giữ nguyên eventId và kiểm tra kết quả đối soát. Webhook dùng cùng bao sự kiện, kiểm tra chữ ký và cửa sổ chống phát lại.
{
"eventId": "evt-test-001",
"eventName": "EvidenceGenerated",
"version": "1.0",
"aggregateId": "arc-test-001",
"correlationId": "corr-test-001",
"idempotencyKey": "synthetic-test-001",
"occurredAt": "2026-10-15T05:00:00Z",
"state": "EVIDENCE_READY",
"reference": "evidence:arc-test-001:1"
}