Webhook, sự kiện và khôi phục
Contract đề xuất cho thông báo bất đồng bộ có xác minh chữ ký, chống replay và thử lại có kiểm soát.
Ảnh cuối gắn với quyết định nghiệp vụ
Envelope và xác minh
eventId, eventType, occurredAt, tenantId, projectId, objectRef, phiên bản và correlationId. Profile minh họa: HMAC-SHA256 trên timestamp + dấu chấm + raw body; X-TR-Timestamp và X-TR-Signature. Secret chỉ ở máy chủ; thuật toán/window cần chốt trong contract thật.
Trùng và thứ tự
Xác minh chữ ký bằng constant-time comparison, kiểm timestamp/window, lưu eventId đã xử lý, kiểm tenant và object phiên bản. Trả 2xx sau khi lưu bền vững; không giả định thứ tự toàn cục. Trùng không lặp side effect.
Thử lại và replay
Đề xuất backoff có jitter và ngân sách thử lại theo contract; 429/5xx/timeout có thể thử lại, 4xx permanent cần sửa cấu hình. Hết ngân sách vào ngoại lệ/DLQ. Replay có phê duyệt, giữ eventId/correlation và lịch sử; không trở thành mức sử dụng tính phí mới mặc định.
Nghiệp vụ tiếp theo
Hai hành trình, một vòng đời hồ sơ
Kết nối hồ sơ giấy và hồ sơ sinh ra ở dạng số bằng định danh, chính sách và bằng chứng xuyên suốt.
Xem chi tiếtBắt đầu tích hợp
Chạy luồng nhận gói → theo dõi job → đăng ký → xác minh bằng dữ liệu tổng hợp.
Xem chi tiếtToàn vẹn, nguồn gốc và bằng chứng
Mỗi loại bằng chứng trả lời một câu hỏi; hash, timestamp và phê duyệt không thay thế nhau.
Xem chi tiếtBắt đầu bằng một phạm vi kiểm tra được.
Chốt loại hồ sơ, tiêu chí chất lượng, quyền và bộ bằng chứng trước khi mở rộng.
Đăng ký khảo sát