احصل على أحداث المكتب الأمامي من Mercateer كروابط ويب (webhooks)
اشترك بنقطة نهاية (endpoint) في أحداث Mercateer وتلقَّ حمولة (payload) موقع عليها فور انتهاء مكالمة أو وصول عميل محتمل أو حجز وظيفة. سجّل وادِر نقاط النهاية من واجهة برمجة التطبيقات (API) أو لوحة التحكم، وتحقّق من كل عملية تسليم باستخدام HMAC.
ما هو Webhooks؟
تدفع روابط الويب (webhooks) أحداث المكتب الأمامي من Mercateer إلى عنوان URL تتحكم به في الوقت الفعلي، مما يسمح لأنظمتك بالتفاعل دون الحاجة لاستعلام واجهة برمجة التطبيقات (API) بشكل متكرر. كل عملية تسليم هي حمولة بصيغة JSON موقع عليها باستخدام HMAC، ويمكنك تسجيل وإدارة نقاط النهاية من واجهة برمجة التطبيقات أو لوحة التحكم، كما أن عمليات التسليم الفاشلة تحاول إعادة الإرسال تدريجيًا.
ما يمكنك فعله باستخدام Webhooks
التثبيت خلال دقائق
أنشئ نقطة نهاية
سجّل عنوان URL الخاص بك واختر الأحداث التي تريد الاشتراك فيها، إما من واجهة برمجة التطبيقات أو من الإعدادات ثم المطور. سيُرجع لك Mercateer سر التوقيع الخاص بتلك النقطة. يتضمن اشتراكا Crew وFleet إمكانية الوصول إلى واجهة برمجة التطبيقات.
تحقّق من التوقيع
مع كل عملية تسليم، اقرأ الطابع الزمني (t) والتوقيع (v1) من ترويسة التوقيع، ثم احسب HMAC-SHA256 للنص "{timestamp}.{raw request body}" باستخدام مفتاح التوقيع السري لديك وقارنه بقيمة v1. ارفض أي طلب لا يتطابق، أو مضى على طابعه الزمني أكثر من 5 دقائق، لتتعامل فقط مع بيانات حديثة قادمة فعلًا من Mercateer. (دالة التحقق في حزمة التطوير لدينا تقوم بذلك كله نيابة عنك.)
تعامل مع محاولات إعادة الإرسال بشكل لا يُغيّر النتيجة
أجب برمز حالة 2xx سريعًا لتأكيد استلام التسليم. تحاول عمليات التسليم الفاشلة إعادة الإرسال تدريجيًا، لذا اجعل معالجك يعتمد على معرّف الحدث (event ID) لتجاهل التكرارات ومعالجة كل حدث مرة واحدة فقط.
الأسئلة الشائعة
يعمل مع كامل أدواتك
يستخدم Mercateer نفس البروتوكولات التي تستخدمها أدواتك الحالية.
استخدم Mercateer مع Webhooks
ابدأ مجانًا ووصّل مكتبك الأمامي خلال دقائق.
لا يلزم بطاقة ائتمان