NHÀ PHÁT TRIỂN

Webhooks

Gửi gọi lại (callback) tới đối tác qua điểm kết nối có người phụ trách, có chữ ký, thử lại có giới hạn, phát lại (replay) và bên nhận xử lý lũy đẳng.

01 / KHÁI NIỆM

Hợp đồng tích hợp

Đăng ký

Điểm kết nối HTTPS, đăng ký sự kiện và người phụ trách.

Chữ ký

Xác minh chữ ký/dấu thời gian trước khi phân tích nội dung.

Phân phối

Xác nhận nhanh, xử lý bất đồng bộ, loại trùng theo event ID.

Lỗi

Chấp nhận thử lại, trùng lặp và sai thứ tự; phát lại phải có bằng chứng.

02 / QUY TRÌNH

Từ môi trường thử nghiệm tới bằng chứng

01Đăng ký điểm kết nối
02Nhận sự kiện có chữ ký
03Xác minh dấu thời gian/chữ ký
04Phản hồi xác nhận
05Loại trùng/xử lý bất đồng bộ
06Thử lại/phát lại khi có thể khôi phục
07Đối chiếu kết quả theo mã tương quan

03 / VÍ DỤ

Nhận webhook cảnh báo

cURL / mã giả

verifySignature(rawBody, signature, timestamp);
if (seen(event.id)) return 204;
enqueue(event); return 204;

04 / BẢO MẬT & VẬN HÀNH

Vận hành chính thức là quyết định dựa trên bằng chứng

Bên nhận webhook phải xác minh chữ ký, loại trùng, chịu được thử lại/sai thứ tự và xử lý bất đồng bộ trước khi được duyệt đưa vào vận hành chính thức.