احصل على أحداث المكتب الأمامي من Mercateer كروابط ويب (webhooks)
اشترك بنقطة نهاية (endpoint) في أحداث Mercateer وتلقَّ حمولة (payload) موقع عليها فور انتهاء مكالمة أو وصول عميل محتمل أو حجز وظيفة. سجّل وادِر نقاط النهاية من واجهة برمجة التطبيقات (API) أو لوحة التحكم، وتحقّق من كل عملية تسليم باستخدام HMAC.
ما هو Webhooks؟
تدفع روابط الويب (webhooks) أحداث المكتب الأمامي من Mercateer إلى عنوان URL تتحكم به في الوقت الفعلي، مما يسمح لأنظمتك بالتفاعل دون الحاجة لاستعلام واجهة برمجة التطبيقات (API) بشكل متكرر. كل عملية تسليم هي حمولة بصيغة JSON موقع عليها باستخدام HMAC، ويمكنك تسجيل وإدارة نقاط النهاية من واجهة برمجة التطبيقات أو لوحة التحكم، كما أن عمليات التسليم الفاشلة تحاول إعادة الإرسال تدريجيًا.
ما يمكنك فعله باستخدام Webhooks
التثبيت خلال دقائق
أنشئ نقطة نهاية
سجّل عنوان URL الخاص بك واختر الأحداث التي تريد الاشتراك فيها، إما من واجهة برمجة التطبيقات أو من الإعدادات ثم المطور. سيُرجع لك Mercateer سر التوقيع الخاص بتلك النقطة. يتضمن اشتراكا Crew وFleet إمكانية الوصول إلى واجهة برمجة التطبيقات.
تحقّق من التوقيع
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
تعامل مع محاولات إعادة الإرسال بشكل لا يُغيّر النتيجة
أجب برمز حالة 2xx سريعًا لتأكيد استلام التسليم. تحاول عمليات التسليم الفاشلة إعادة الإرسال تدريجيًا، لذا اجعل معالجك يعتمد على معرّف الحدث (event ID) لتجاهل التكرارات ومعالجة كل حدث مرة واحدة فقط.
الأسئلة الشائعة
يعمل مع كامل أدواتك
يستخدم Mercateer نفس البروتوكولات التي تستخدمها أدواتك الحالية.
استخدم Mercateer مع Webhooks
ابدأ مجانًا ووصّل مكتبك الأمامي خلال دقائق.
لا يلزم بطاقة ائتمان