Mercateer کے فرنٹ آفس ایونٹس ویب ہکس کے طور پر حاصل کریں
اپنے کسی اینڈ پوائنٹ کو Mercateer ایونٹس پر سبسکرائب کریں اور کال ختم ہوتے ہی، لیڈ آتے ہی یا کام بک ہوتے ہی دستخط شدہ پے لوڈ حاصل کریں۔ اینڈ پوائنٹس API یا ڈیش بورڈ سے رجسٹر اور منظم کریں، اور ہر ڈیلیوری کی تصدیق HMAC سے کریں۔
Webhooks کیا ہے؟
ویب ہکس، Mercateer کے فرنٹ آفس ایونٹس کو حقیقی وقت میں آپ کے اپنے کنٹرول والے URL پر بھیجتے ہیں، تاکہ آپ کے سسٹمز API کو بار بار پوچھے بغیر ردِعمل دے سکیں۔ ہر ڈیلیوری ایک JSON پے لوڈ ہوتی ہے جس پر HMAC سے دستخط ہوتے ہیں، اینڈ پوائنٹس آپ API یا ڈیش بورڈ سے رجسٹر اور منظم کرتے ہیں، اور ناکام ڈیلیوریز وقفے کے ساتھ دوبارہ بھیجی جاتی ہیں۔
Webhooks کے ساتھ آپ کیا کر سکتے ہیں
منٹوں میں انسٹال کریں
اینڈ پوائنٹ بنائیں
اپنا URL رجسٹر کریں اور سبسکرائب کرنے کے لیے ایونٹس چنیں، API سے یا Settings، پھر Developer میں۔ Mercateer اُس اینڈ پوائنٹ کے لیے ایک سائننگ سیکرٹ دیتا ہے۔ API رسائی Crew اور Fleet پلانز میں شامل ہے۔
دستخط کی تصدیق کریں
ہر ڈیلیوری پر، سگنیچر ہیڈر سے ٹائم اسٹیمپ (t) اور دستخط (v1) پڑھیں، پھر اپنے سائننگ سیکرٹ کے ساتھ "{timestamp}.{raw request body}" اسٹرنگ کا HMAC-SHA256 نکالیں اور اس کا v1 ویلیو سے موازنہ کریں۔ جو درخواست میل نہ کھائے، یا جس کا ٹائم اسٹیمپ 5 منٹ سے پرانا ہو، اسے مسترد کر دیں، تاکہ آپ صرف اُنہی تازہ پے لوڈز پر عمل کریں جو واقعی Mercateer سے آئے ہوں۔ (ہماری SDK کا verify ہیلپر یہ سب آپ کے لیے خود کر دیتا ہے۔)
دوبارہ کوششوں کو idempotent انداز میں سنبھالیں
ڈیلیوری ملنے کی تصدیق کے لیے جلدی 2xx جواب دیں۔ ناکام ڈیلیوریز وقفے کے ساتھ دوبارہ بھیجی جاتی ہیں، اس لیے اپنے ہینڈلر کو ایونٹ ID پر مبنی رکھیں تاکہ نقل نظرانداز ہو جائے اور ہر ایونٹ ایک ہی بار پروسیس ہو۔
اکثر پوچھے جانے والے سوالات
آپ کے پورے سیٹ اپ کے ساتھ چلتا ہے
Mercateer اُنہی پروٹوکولز پر بات کرتا ہے جو آپ کے موجودہ ٹولز استعمال کرتے ہیں۔
Mercateer کو Webhooks کے ساتھ کام پر لگائیں
مفت شروع کریں اور اپنا فرنٹ آفس منٹوں میں جوڑ لیں۔
کریڈٹ کارڈ کی ضرورت نہیں