รับเหตุการณ์หน้าร้านของ Mercateer ผ่านเว็บฮุก
สมัครรับเหตุการณ์จาก Mercateer ที่ endpoint แล้วรับเพย์โหลดที่ถูกเซ็นทันทีเมื่อสายโทรจบ ลีดเข้ามา หรือมีการจองงาน ลงทะเบียนและจัดการ endpoint ผ่าน API หรือแดชบอร์ด และตรวจสอบทุกการส่งด้วย HMAC
Webhooks คืออะไร?
เว็บฮุกจะผลักดันเหตุการณ์หน้าร้านของ Mercateer ไปยัง URL ที่คุณควบคุมแบบเรียลไทม์ ทำให้ระบบของคุณสามารถตอบสนองได้ทันทีโดยไม่ต้องสอบถาม API ซ้ำๆ การส่งแต่ละครั้งเป็นเพย์โหลด JSON ที่ถูกเซ็นด้วย HMAC คุณสามารถลงทะเบียนและจัดการ endpoint ผ่าน API หรือแดชบอร์ด และหากการส่งล้มเหลว ระบบจะลองส่งซ้ำโดยเว้นระยะห่าง
สิ่งที่คุณทำได้กับ Webhooks
ติดตั้งภายในไม่กี่นาที
สร้าง endpoint
ลงทะเบียน URL ของคุณและเลือกเหตุการณ์ที่ต้องการสมัครรับ ผ่าน API หรือที่ Settings > Developer Mercateer จะส่ง signing secret สำหรับ endpoint นั้นให้ การเข้าถึง API รวมอยู่ในแผน Crew และ Fleet
ตรวจสอบลายเซ็น
ทุกครั้งที่มีการส่งข้อมูลเข้ามา ให้อ่านค่า timestamp (t) และ signature (v1) จากเฮดเดอร์ลายเซ็น จากนั้นคำนวณ HMAC-SHA256 ของสตริง "{timestamp}.{raw request body}" ด้วย signing secret ของคุณ แล้วเทียบกับค่า v1 ให้ปฏิเสธคำขอที่ค่าไม่ตรงกัน หรือมี timestamp เก่ากว่า 5 นาที เพื่อให้คุณประมวลผลเฉพาะข้อมูลใหม่ที่มาจาก Mercateer จริง ๆ (ตัวช่วย verify ใน SDK ของเราจัดการทั้งหมดนี้ให้แล้ว)
จัดการการลองส่งซ้ำแบบ idempotent
ตอบกลับด้วยรหัส 2xx อย่างรวดเร็วเพื่อยืนยันการได้รับ หากการส่งล้มเหลว ระบบจะลองส่งซ้ำโดยเว้นระยะห่าง ดังนั้นให้ใช้ event ID เป็นคีย์ในแฮนเดลอร์ของคุณ เพื่อละเว้นข้อมูลซ้ำและประมวลผลแต่ละเหตุการณ์เพียงครั้งเดียว
คำถามที่พบบ่อย
ทำงานร่วมกับชุดเครื่องมือทั้งหมดของคุณ
Mercateer ใช้โปรโตคอลเดียวกันกับเครื่องมือที่คุณใช้อยู่แล้ว
เริ่มใช้งาน Mercateer กับ Webhooks
เริ่มใช้งานฟรีและเชื่อมแผนกหน้าบ้านของคุณภายในไม่กี่นาที
ไม่ต้องใช้บัตรเครดิต