Webhook là một yêu cầu HTTP mà một dịch vụ gửi đến một URL mà bạn đã đăng ký mỗi khi một sự kiện cụ thể xảy ra. Nó cho phép hệ thống của bạn nhận dữ liệu ngay khi nó xảy ra, thay vì phải truy vấn một API bằng cách gọi lại liên tục để xem có gì mới không. Trong một pipeline dữ liệu, điều đó có nghĩa là một công việc có thể phản ứng với một sự kiện ngay khi nguồn báo cáo nó.

Nền tảng thanh toán Stripe, chẳng hạn, gửi các sự kiện webhook đến điểm cuối của bạn qua HTTPS dưới dạng một payload JSON. Điểm cuối của bạn phải chấp nhận các yêu cầu POST và xử lý dữ liệu sự kiện mà nó nhận được.

Cách thức hoạt động của việc gửi Webhook

Tài liệu của Stripe cho thấy các cơ chế chính:

  • Đăng ký: Bạn đăng ký một URL điểm cuối. Trong chế độ trực tiếp, Stripe yêu cầu một URL HTTPS có thể truy cập công khai.
  • Xác nhận nhanh: Điểm cuối nên trả về mã trạng thái 2xx nhanh chóng, trước bất kỳ logic phức tạp nào có thể gây ra thời gian chờ.
  • Thử lại: Nếu việc gửi không thành công, Stripe sẽ thử lại trong tối đa ba ngày với phương pháp tăng dần trong chế độ trực tiếp.
  • Thứ tự: Stripe không đảm bảo rằng các sự kiện đến theo thứ tự mà chúng được tạo ra.

Bảo mật một Điểm cuối Webhook

  • Xác minh chữ ký: Stripe ký mỗi sự kiện bằng HMAC sử dụng SHA-256 và đưa chữ ký vào tiêu đề Stripe-Signature.
  • Chặn các lần phát lại: Payload đã ký bao gồm một dấu thời gian, vì vậy bạn có thể từ chối các sự kiện quá cũ.
  • Xử lý các bản sao: Một điểm cuối có thể nhận cùng một sự kiện nhiều hơn một lần. Ghi lại các ID sự kiện đã xử lý và bỏ qua các bản sao.
  • Danh sách cho phép người gửi: Stripe gửi webhooks từ một danh sách IP đã công bố mà bạn có thể hạn chế tường lửa của mình.

Các Sử Dụng Webhook Thông Dụng

  • Mã và triển khai: GitHub gửi một payload HTTP POST đến URL của bạn cho các sự kiện kho mà bạn đã đăng ký. Tài liệu của nó liệt kê các sử dụng như bắt đầu các bản dựng CI, cập nhật một trình theo dõi sự cố bên ngoài, làm mới một gương sao lưu và triển khai lên máy chủ sản xuất.
  • Thanh toán: Webhooks của Stripe cho phép bạn phản ứng với các sự kiện bất đồng bộ, chẳng hạn như một ngân hàng xác nhận một khoản thanh toán, một khách hàng tranh chấp một khoản phí hoặc một khoản thanh toán định kỳ thành công.
  • Chỉ đăng ký những gì bạn cần: Stripe khuyên bạn không nên lắng nghe các sự kiện bổ sung hoặc tất cả vì điều đó gây áp lực không cần thiết lên máy chủ của bạn.

Các Thuật Ngữ Liên Quan