Webhook คือคำขอ HTTP ที่บริการส่งไปยัง URL ที่คุณลงทะเบียนเมื่อเกิดเหตุการณ์เฉพาะ มันช่วยให้ระบบของคุณรับข้อมูลตามเวลาจริง แทนที่จะต้องเรียก API ซ้ำแล้วซ้ำเล่าเพื่อตรวจสอบว่ามีข้อมูลใหม่หรือไม่ ในกระบวนการจัดการข้อมูล หมายความว่างานสามารถตอบสนองต่อเหตุการณ์ได้ทันทีที่แหล่งข้อมูลรายงาน
แพลตฟอร์มการชำระเงิน Stripe เป็นตัวอย่างที่ดีที่ส่งเหตุการณ์ webhook ไปยังจุดสิ้นสุดของคุณผ่าน HTTPS ในรูปแบบ JSON จุดสิ้นสุดของคุณต้องยอมรับคำขอ POST และประมวลผลข้อมูลเหตุการณ์ที่ได้รับ
วิธีการทำงานของการส่ง Webhook
เอกสารของ Stripe แสดงกลไกหลัก:
- การลงทะเบียน: คุณลงทะเบียน URL จุดสิ้นสุด ในโหมดสด Stripe ต้องการ URL HTTPS ที่เข้าถึงได้สาธารณะ
- การยืนยันอย่างรวดเร็ว: จุดสิ้นสุดควรส่งกลับรหัสสถานะ 2xx อย่างรวดเร็ว ก่อนที่ตรรกะที่ซับซ้อนใด ๆ ที่อาจทำให้เกิดการหมดเวลา
- การลองใหม่: หากการส่งล้มเหลว Stripe จะลองใหม่เป็นเวลาถึงสามวันด้วยการเพิ่มระยะเวลาที่นานขึ้นในโหมดสด
- การจัดลำดับ: Stripe ไม่รับประกันว่าเหตุการณ์จะมาถึงในลำดับที่สร้างขึ้น
การรักษาความปลอดภัยของจุดสิ้นสุด Webhook
- ตรวจสอบลายเซ็น: Stripe ลงนามในแต่ละเหตุการณ์ด้วย HMAC โดยใช้ SHA-256 และใส่ลายเซ็นในหัวข้อ
Stripe-Signature - บล็อกการเล่นซ้ำ: ข้อมูลที่ลงนามรวมถึงเวลาที่ระบุ ดังนั้นคุณสามารถปฏิเสธเหตุการณ์ที่เก่าจนเกินไป
- จัดการข้อมูลซ้ำ: จุดสิ้นสุดสามารถรับเหตุการณ์เดียวกันมากกว่าหนึ่งครั้ง บันทึก ID ของเหตุการณ์ที่ประมวลผลและข้ามการซ้ำ
- อนุญาตให้ส่ง: Stripe ส่ง webhook จากรายการ IP ที่เผยแพร่ซึ่งคุณสามารถจำกัดไฟร์วอลล์ของคุณได้
การใช้งาน Webhook ที่พบบ่อย
- โค้ดและการปรับใช้: GitHub ส่งข้อมูล HTTP POST ไปยัง URL ของคุณสำหรับเหตุการณ์ในที่เก็บที่คุณสมัครรับ เอกสารของมันระบุการใช้งานเช่นการเริ่มต้นการสร้าง CI การอัปเดตตัวติดตามปัญหาภายนอก การรีเฟรชสำเนาสำรอง และการปรับใช้ไปยังเซิร์ฟเวอร์การผลิต
- การชำระเงิน: Webhook ของ Stripe ช่วยให้คุณตอบสนองต่อเหตุการณ์ที่ไม่ซิงโครนัส เช่น ธนาคารยืนยันการชำระเงิน ลูกค้าคัดค้านการเรียกเก็บเงิน หรือการชำระเงินที่เกิดขึ้นซ้ำสำเร็จ
- สมัครรับเฉพาะสิ่งที่คุณต้องการ: Stripe แนะนำไม่ให้ฟังเหตุการณ์เพิ่มเติมหรือทั้งหมดเพราะจะทำให้เซิร์ฟเวอร์ของคุณทำงานหนักเกินไป