يفتح في علامة تبويب جديدة
عنوان رسومي مزخرف لتتبع روابط الويب

شرح لتقنية تتبع الويب هوك: للمطورين وتجار التجزئة عبر الإنترنت

يُعدّ رابط التتبع عبر الويب رسالة دفع تلقائية عبر بروتوكول HTTP، تُرسل حالة الشحنة إلى نظام آخر في الوقت الفعلي فور حدوث أي تغيير فيها. فبدلاً من الاستعلام المستمر من واجهة، تُرسل خدمة الطرود أو منصة الشحن الحالة الجديدة مباشرةً إلى عنوان URL يُحدده المُستلم. يُساهم هذا في تخفيف الضغط على الخادم، وتقليل زمن الاستجابة بشكل ملحوظ مقارنةً بالاستقصاء الدوري، ويُشكّل الأساس التقني للوحات معلومات التتبع، وإشعارات العملاء، وعمليات الجمارك الآلية. تشرح الأقسام التالية التقنية الأساسية، وإجراءات الأمان اللازمة، وتُقدّم مثالاً عملياً على الكود.


باختصار:

  • تقوم خدمة تتبع Webhooks بالإبلاغ عن تغييرات الحالة في الوقت الفعلي وتقليل حمل الخادم من خلال الإشعارات القائمة على الدفع مقارنة بالاستقصاء.
  • يتم التحقق من التوقيع باستخدام نص الطلب غير المعدل مع HMAC-SHA256 لضمان المصداقية والسلامة.
  • يتم وضع أحداث webhook المستلمة فورًا في قائمة انتظار لتجنب حالات انتهاء المهلة وتأخيرات المعالجة.
  • ينبغي للنظام تخزين معرفات الأحداث مؤقتًا ومعالجتها بشكل متكرر لمنع عمليات التسليم المكررة بشكل موثوق.
  • تعمل شركة Paket International على تبسيط عملية دمج روابط الويب من خلال واجهة مركزية تجمع أحداث الشحن في لوحة تحكم.

باقة دولية
إدارة الشحن الدولي بسهولة أكبر
تجمع شركة Paket International بين أحداث الشحن والخدمات الجمركية وتتبع الشحنات في لوحة تحكم شفافة.

اكتشف الباقة الدولية

Inhaltsverzeichnis

ما هو رابط التتبع؟ تعريفه وأحداث التتبع النموذجية

يعمل Webhook بشكل عكسي لواجهة برمجة التطبيقات التقليدية (API). ففي واجهة برمجة التطبيقات العادية، يستعلم نظامك باستمرار عن التحديثات. أما Webhook فيعكس ذلك: إذ يُعلمك المُرسِل فور حدوث أي جديد، ولذلك يُطلق على هذا النمط غالبًا اسم واجهة برمجة التطبيقات العكسية. فبدلًا من التحقق من خدمة البريد كل دقيقة لمعرفة ما إذا كان هناك أي جديد، يُسجل نظامك عنوان الاستلام مرة واحدة فقط، ولا يُقدم المُرسِل التحديثات إلا عند الحاجة.

في سياق الشحن، يُؤدي كل تغيير في حالة الشحنة تقريبًا إلى حدث منفصل. تشمل أحداث التتبع النموذجية ما يلي:

  • تم إنشاء ملصق الشحن
  • تم استلام الشحنة بواسطة خدمة توصيل الطرود.
  • تم فحص الشحنة في مركز الفرز.
  • الشحنة في طريقها للتسليم
  • تم تسليم الشحنة بنجاح.

الميزة واضحة: تحديثات فورية دون استعلامات متكررة، وتقليل عبء المعالجة على كلا الجانبين، وأساس طبيعي للأتمتة. أما العيب فلا يظهر إلا أثناء التشغيل: يجب أن يكون نظامك متاحًا في جميع الأوقات، وأن يتحمل الانقطاعات، وأن يتعامل مع الرسائل المكررة أو المتأخرة. وهذا تحديدًا ما تتناوله الأقسام التالية.

كيف يتم تنظيم رسالة رابط التتبع؟

من الناحية التقنية، يُعدّ رابط التتبع عبر الويب مجرد طلب HTTP POST إلى عنوان URL تحدده. ويتبع المحتوى المُستلم نمطًا رباعيًا في أغلب الأحيان: مُعرّف حدث فريد، ونوع الحدث، وطابع زمني، وكائن بيانات يحتوي على معلومات الشحنة الفعلية. وقد أصبح هذا التنسيق شائعًا جدًا لدرجة أنه بات مرادفًا لـ... المعيار الفعلي لحمولات webhook قبعة المنشأة.

إنشاء حمولة تتبع webhook

بالإضافة إلى نص الرسالة، تحتوي رؤوس HTTP على معلومات إضافية مهمة. Content‑Type: application/json يتضمن ذلك رأسية التوقيع (غالباً) X‑Signature أودر X‑Hub‑Signature‑256) ومعرف التسليم، مما يسمح بتمييز محاولات التسليم الفردية.

هناك نقطة غالباً ما يتم تجاهلها عملياً: يجب أن يكون التوقيع أعلى جسد خام غير معدل يجب حساب قيمة التجزئة قبل أن تقوم أي مكتبة JSON بتحليلها. حتى تغيير التنسيق، مثل اختلاف المسافات، يؤدي إلى قيمة تجزئة مختلفة، وبالتالي إلى رفض الرسالة بشكل خاطئ.

كيف يمكنك تأمين مستقبل Webhook؟

لا يكون المستلم جاهزًا للإنتاج إلا إذا أجاب بشكل موثوق على ثلاثة أسئلة: هل الرسالة واردة فعلاً من المرسل المذكور؟ هل تمت معالجتها بالفعل؟ ماذا يحدث في حال فشل المعالجة؟ أي شخص يتجاهل هذه الأسئلة الثلاثة سيتلقى عاجلاً أم آجلاً تأكيدات طلب مكررة أو بيانات جمركية مفقودة.

يُعد التحقق من التوقيع باستخدام HMAC-SHA256 على نص الرسالة الخام الخطوة الأولى. يُولّد السر المشترك بين المُرسِل والمُستقبِل قيمة تجزئة، يُعيد المُستقبِل حسابها ومقارنتها. نوع المقارنة بالغ الأهمية: مقارنة سلسلة نصية عادية مع === يُعتبر هذا الأسلوب غير آمن بشكل ملحوظ لأنه يتوقف فورًا عند كل حرف غير صحيح، مما يكشف عن فرق في التوقيت يمكن للمهاجمين استغلاله. في Node.js، يتم التعامل مع هذا الأمر بواسطة... crypto.timingSafeEqual هذه المهمة ثابتة بمرور الوقت؛ في لغة بايثون، المقابل لها هو compare_digest-وظيفة.

  • تحقق دائمًا من التوقيع باستخدام النص الخام غير المعدل، وليس باستخدام الكائن الذي تم تحليله مسبقًا.
  • تحقق من الطابع الزمني في الحمولة مقابل نافذة زمنية مدتها خمس دقائق تقريبًا لمنع هجمات إعادة التشغيل باستخدام رسائل قديمة ولكنها موقعة بشكل صحيح.
  • قم بتخزين معرفات الأحداث التي تمت معالجتها مسبقًا مؤقتًا لمنع المعالجة المكررة لعمليات التسليم المتكررة.
  • لفرض مبدأ التكرار من الناحية التقنية، على سبيل المثال من خلال عملية إدراج ذرية في قاعدة البيانات مع قيد فريد أو SET NX في Redis
  • ينبغي نقل الأحداث التي فشلت في نهاية المطاف بعد عدة محاولات إلى قائمة انتظار الرسائل غير القابلة للتنفيذ بدلاً من تجاهلها بصمت.

يُستخدم هذا المزيج من الطوابع الزمنية الموقعة وتخزين المعرفات مؤقتًا للحماية من هجمات إعادة التشغيل أيضًا بشكل شائع أدلة الأمان الخاصة بخطافات الويب empfohlen.

من المهم إدارة التوقعات: تعمل معظم جهات إرسال إشعارات الويب وفقًا لمبدأ "التسليم مرة واحدة على الأقل"، أي أنها تُسلّم الشحنة مرة واحدة على الأقل. عمليًا، هذا يعني أن عمليات التسليم المكررة هي القاعدة، وليست خطأً. النظام الذي لا يُعالج البيانات بشكل متكرر سيؤدي عاجلًا أم آجلًا إلى ظهور إشعارات شحن مكررة أو حالات جمركية غير صحيحة.

نصيحة احترافية: لا تحذف معرّفات الأحداث المخزنة مؤقتًا فور معالجتها، بل بعد انقضاء فترة إعادة المحاولة المحددة للمرسل. يكرر العديد من مزودي الخدمة عمليات التسليم الفاشلة على مدار عدة ساعات أو أيام، وحذف المعرّف مبكرًا جدًا يُحدث ثغرة يُفترض أن يُغلقها فحص التكرار.

كيف يمكنك معالجة أحداث Webhook دون التعرض لخطر انقطاع الاتصال؟

لا يكمن الخطر التشغيلي الأكبر في استخدام Webhooks في الأمان، بل في وقت الاستجابة. تفرض خدمات الشحن ومنصات التوصيل حدودًا زمنية صارمة: فبعض مزودي الخدمة يتوقعون استجابة 2xx في غضون ثوانٍ معدودة، بينما يسمح آخرون بما يصل إلى 30 ثانية، كما هو موضح في توصيات GitHub. إذا تجاوزت مدة الاستجابة هذه، يعتبر المرسل عملية التسليم فاشلة ويعيد إرسالها، مما يُغرق قاعدة بياناتك بمزيد من النسخ المكررة.

الحل هو الفصل التام بين الاستلام والمعالجة:

  1. تحقق فوراً من البيانات الأولية والتوقيعات دون الحاجة إلى منطق أعمال معقد.
  2. اكتب الحدث إلى قائمة انتظار، على سبيل المثال باستخدام BullMQ أو Amazon SQS أو pg-boss.
  3. فوراً مع 200 OK الرد قبل بدء المعالجة الفعلية.
  4. يقوم عامل منفصل يعمل في الخلفية باسترداد المهمة من قائمة الانتظار وتنفيذ المنطق الفعلي.
  5. يتطابق معرف المهمة في قائمة الانتظار مع معرف الحدث، لذلك يتم أيضًا إزالة التكرار من قائمة الانتظار نفسها.

أي شخص يتعامل مع معالجة Webhook بطريقة حظرية ضمن الطلب نفسه سيواجه عاجلاً أم آجلاً تعارضًا مع مهلة المرسل. يجب وضع الأحداث في قائمة الانتظار فورًا؛ أما المعالجة الفعلية فتتم بشكل غير متزامن في الخلفية.

يجب أن يعتمد وقت بقاء مُعرّف الحدث في الذاكرة المؤقتة (أي مدة بقاء مُعرّف الحدث فيها) على نافذة إعادة المحاولة الفعلية للمُرسِل، وليس على قيمة عشوائية. ولتخطيط السعة، يجدر مراعاة عمق قائمة الانتظار: فإذا ازداد باستمرار، يُعالج العامل الأحداث ببطءٍ أكبر من سرعة وصولها، ويجب تطبيق آليات التحكم في التدفق العكسي قبل امتلاء الذاكرة. كما يجب تفعيل تنبيه لقائمة انتظار الرسائل غير المُسلّمة منذ البداية، لأن ازديادها عادةً ما يكون أول مؤشر على وجود مشكلة أعمق.

كيف يبدو نموذج التعليمات البرمجية لاستقبال إشعار الويب؟

يتبع معالج البيانات النظيفة دائمًا نفس الترتيب: أولًا التحقق، ثم التخزين، ثم المعالجة. يعتمد التدفق التالي على أنماط Node.js الشائعة، ويمكن نقله إلى أي لغة تدعم HMAC وعمليات قواعد البيانات الذرية.

  1. اقرأ نص الطلب كصيغة خام غير معدلة، دون تحليله مسبقًا.
  2. استخرج التوقيع المرسل من رأس الرسالة.
  3. باستخدام السر المشترك، احسب توقيع HMAC-SHA256 المتوقع من النص الخام.
  4. قارن بين التوقيعين باستخدام دالة ثابتة زمنياً، ولا تستخدم أبداً عامل المساواة البسيط.
  5. لا تقم بتحليل نص الطلب كـ JSON إلا بعد التحقق الناجح.
  6. اكتب معرف الحدث بشكل ذري إلى قاعدة البيانات، على سبيل المثال باستخدام قيد فريد يرفض التكرارات تلقائيًا.
  7. ضع الحدث في قائمة الانتظار للمعالجة.
  8. فوراً مع 200 OK إجابة.

السبب وراء ترتيب الخطوات في الخطوة الخامسة بسيط: أي شخص يقوم بتحليل بيانات JSON قبل التحقق من التوقيع يقوم بمعالجة بيانات قد تكون مُعدّلة، حتى لو بدت عملية المعالجة نفسها غير ضارة. تحقق أولاً، ثم فسّر.

عند حدوث الأخطاء، تصبح دلالات HTTP الصحيحة أمراً بالغ الأهمية. 4xx- تشير الحالة إلى المرسل "هذه الرسالة معيبة بشكل أساسي، لا تكررها"، على سبيل المثال في حالة التوقيع غير الصحيح. 5xx-Status تعني "هناك عطل ما من جهتي، يرجى المحاولة مرة أخرى لاحقًا"، على سبيل المثال في حالة فشل قاعدة البيانات.

نصيحة احترافية: سجّل كل توقيع مرفوض مع الطابع الزمني وعنوان IP المصدر. غالبًا ما يكون الارتفاع المفاجئ في عمليات التحقق الفاشلة من التوقيعات أول مؤشر على وجود خطأ في تكوين كلمة المرور السرية بعد عملية التدوير، وليس هجومًا.

ما الغرض المحدد الذي تخدمه روابط التتبع في مجال الشحن؟

في العمليات اليومية للمتاجر الإلكترونية، تتولى روابط التتبع مهامًا كانت تتطلب سابقًا تتبعًا يدويًا. فبمجرد أن تُبلغ خدمة توصيل الطرود عن عملية مسح جديدة، يقوم رابط التتبع تلقائيًا بتحديث صفحة التتبع العامة، وإرسال إشعار إلى العملاء، أو بدء خطوة تنفيذ داخلية، مثل الموافقة على الفاتورة بعد التسليم.

  • تعرض صفحات التتبع الحالة الحالية دون تأخير ناتج عن الفحص اليدوي.
  • يتم إرسال إشعارات العملاء عبر البريد الإلكتروني أو الرسائل النصية القصيرة تلقائيًا لكل تغيير ذي صلة في الحالة.
  • تتلقى الأنظمة الداخلية مثل المتجر أو نظام تخطيط موارد المؤسسات أو نظام إدارة علاقات العملاء الحالة الجديدة عبر حمولة مبسطة، دون أن يضطر أي شخص إلى إدخال البيانات يدويًا.
  • انخفضت استفسارات خدمة WISMO ("أين طلبي") بشكل ملحوظ لأن العملاء يمكنهم التحقق من الحالة بأنفسهم.
  • يمكن إرسال التغييرات المتعلقة بالحالة الجمركية تلقائيًا إلى أنظمة الجمارك، دون الحاجة إلى إجراءات ورقية.

هام: غالبًا ما يوفر رابط الويب نفسه معلومات أساسية فقط، مثل رقم التتبع والحالة الحالية. للحصول على معلومات أكثر تفصيلًا، تشير بعض خدمات الشحن أيضًا إلى واجهة برمجة تطبيقات تتبع منفصلة، ​​يتم الاستعلام عنها عند الحاجة. أولئك الذين يديرون متجرهم عبر WooCommerce أو يربط نظامًا مشابهًا، وعادةً ما يتم تغذية هذه الأحداث مباشرةً في نظام إدارة الطلبات الحالي.

كيف يمكنك اكتشاف حالات فشل Webhook قبل أن يكتشفها العملاء؟

يعمل نظام الويب هوك بدون مراقبة بشكل أعمى. أهم مؤشرات الأداء الرئيسية هي معدل نجاح التسليم (DSR)، أي نسبة عمليات التسليم التي تمت معالجتها بنجاح، ومعدل إعادة المحاولة، وعمق جودة التسليم (DLQ)، وزمن استجابة المعالجة بين الاستلام والإكمال.

  • يشير معدل نجاح التسليم الأقل من المستوى المعتاد إلى وجود مشكلة في التحقق من التوقيع أو إمكانية الوصول.
  • يشير ازدياد عمق DLQ إلى أن الأحداث تفشل في نهاية المطاف، وليس مجرد تأخيرها.
  • يمنع التنبيه الذي يتم إطلاقه بعد حوالي خمسة أعطال متتالية في نقطة النهاية، حدوث عطل دون أن يلاحظه أحد لساعات.
  • غالباً ما يكون ازدياد زمن استجابة المعالجة أول علامة على وجود ازدحام في قائمة الانتظار.

تعتمد دقة عتبة التنبيه على نوع الحدث: ففي الأحداث المتعلقة بالدفع، يُصدر تنبيه حتى بعد محاولة فاشلة واحدة، بينما في الأحداث المتعلقة بالتحليلات فقط، يكفي مستوى تحمل أعلى. قبل بدء التشغيل، يجب تضمين حالات اختبار لعمليات التسليم المتكررة، والبيانات المرسلة بتنسيق غير صحيح، ومعالجة البيانات البطيئة بشكل مصطنع، في كل قائمة تحقق.

نصيحة احترافية: قم بمحاكاة انقطاع كامل لنقطة النهاية الخاصة بك لمدة خمس دقائق، وراقب سلوك قائمة إعادة المحاولة لدى المُرسِل. سيتيح لك هذا معرفة ما إذا كانت قائمة الانتظار الخاصة بالرسائل المفقودة والتنبيهات تعمل بالفعل قبل بدء التشغيل الفعلي.

قائمة التحقق: تفعيل نقطة نهاية webhook في عشر خطوات

  1. حدد الأحداث ذات الصلة التي يحتاجها نظامك فعلياً.
  2. اجعل حجم البيانات المرسلة في حده الأدنى قدر الإمكان؛ ولا تشترك في الحقول غير الضرورية.
  3. فرض استخدام بروتوكول HTTPS وإنشاء سر للتحقق من التوقيع.
  4. اجعل نص الطلب الخام متاحًا دون تحليل مسبق.
  5. تحقق من توقيع HMAC باستخدام مقارنة الثوابت الزمنية.
  6. اكتب معرف الحدث بشكل ذري في قاعدة البيانات لمنع التكرارات.
  7. ضع الحدث في قائمة انتظار المعالجة.
  8. خلال الإطار الزمني الذي حدده المرسل مع 200 OK إجابة.
  9. قم بإعداد قائمة انتظار للرسائل غير القابلة للتسليم وتنبيهات للأحداث الفاشلة.
  10. قم بتوثيق توقعاتك الخاصة فيما يتعلق بالأحداث والحقول وسلوك إعادة المحاولة.
مجموعة الخطوات الهدف أداة نموذجية
SICHERHEIT ضمان صحة الرسالة HMAC-SHA256، HTTPS
تحويل تجنب انتهاء المهلة BullMQ، SQS، pg-boss
Betrieb اكتشاف الأعطال مبكراً قائمة الرسائل غير القابلة للتسليم، تنبيه

كيف تستخدم منصة الشحن خطافات الويب عمليًا

يدرك أي شخص يُطوّر روابط تتبع خاصة به سريعًا حجم العمل التشغيلي اللازم للتحقق من التوقيعات، وإدارة قوائم الانتظار، ومعالجة حالة الشحنات الجمركية قبل وصول أول تحديث موثوق لحالة الشحنة إلى العميل. تتولى شركة باكيت إنترناشونال هذا الجزء تحديدًا من سلسلة الشحن، وتُؤتمت تحديثات الحالة، وتفعيل الإجراءات الجمركية، وتتبع الشحنات مركزيًا، ما يُغني تجار التجزئة عبر الإنترنت عن إنشاء مُستقبِل روابط خاص بهم لكل خدمة شحن على حدة.

تربط المنصة خدمات الطرود مثل DHL و UPS و FedEx و DPD و DB Schenker عبر واجهة مشتركة وتوحد أحداث الشحن الخاصة بها في موقع مركزي واحد. لوحة تتبع البياناتتتيح عمليات تكامل واجهات برمجة التطبيقات والإضافات، على سبيل المثال مع ووكومرس أو أنظمة المتاجر المشابهة، إمكانية إدخال هذه الأحداث مباشرةً في العمليات الحالية، بدلاً من ربط كل مزود خدمة على حدة. وهذا لا يقلل من جهد التطوير فحسب، بل يخفض التكاليف أيضاً. لوت بحسب شركة باكيت إنترناشونال، تنخفض تكاليف الشحن بشكل ملحوظ بفضل أتمتة إجراءات التخليص الجمركي وإعداد المستندات بدلاً من معالجتها يدوياً. أي شخص يثق في شركة باكيت إنترناشونال لشحن بضائعه دولياً، بما في ذلك التخليص الجمركي، سيستفيد من هذه الميزة. منصة الشحن يمكن لمن يرغب في تسليمها أن يجدها تحت أسعار الشحن الحالية نقطة البداية الصحيحة لحجم شحناتك الخاصة.

الأسئلة الشائعة

ما هو الويب هوك، شرح بسيط؟

يُعدّ Webhook رسالةً آليةً يرسلها نظامٌ إلى آخر فور وقوع حدثٍ مُحدد، مثل تغيير حالة الشحنة. وعلى عكس الاستعلام التقليدي، لا يحتاج المُستلم إلى التحقق باستمرار، بل يتم إخطاره تلقائيًا بمجرد وجود أي جديد.

كيف أقوم ببرمجة رابط الويب؟

لتلقي الحدث، تقوم بإعداد نقطة نهاية HTTPS تقرأ نص الطلب الخام، وتتحقق من التوقيع المصاحب بمقارنة ثابتة زمنية، ثم تعالج الحدث كبيانات JSON. بعد ذلك، تكتب معرّف الحدث في قاعدة البيانات بشكل ذري، وتضع المهمة في قائمة انتظار، وتستجيب فورًا. 200 OK، حتى لا يكرر المرسل عملية التسليم.

ما الذي يميز Webhook عن استعلام API التقليدي؟

باستخدام واجهة برمجة التطبيقات التقليدية، يطلب نظامك بيانات جديدة باستمرار، غالبًا على فترات زمنية ثابتة، حتى لو لم يطرأ أي تغيير. أما تقنية الويب هوك فتعكس هذا الوضع: إذ لا يرسل المُرسِل طلبًا إلا عند وقوع حدث ما بالفعل، مما يقلل من حمل الخادم وزمن الاستجابة.

كيف يمكنك حماية نفسك من عمليات تسليم روابط الويب المكررة؟

تُعدّ عمليات التسليم المكررة أمرًا طبيعيًا لمعظم مُرسلي Webhook، حيث يعمل العديد من مزودي الخدمة وفقًا لمبدأ "التسليم مرة واحدة على الأقل". يتم إدخال البيانات في قاعدة البيانات بشكل ذري مع قيد فريد على مُعرّف الحدث أو SET NX في Redis، يمنع هذا الحدث الذي تمت معالجته بالفعل من إعادة تنفيذه.

هل تقدم شركة Paket International خدمة دمج Webhook الخاصة بها؟

تجمع شركة باكيت إنترناشونال بيانات الشحنات من مختلف شركات خدمات الطرود في لوحة تحكم مركزية لتتبع الشحنات، وتتيح هذه المعلومات لأنظمة المتاجر عبر واجهة برمجة التطبيقات (API) وتكاملات الإضافات. يمكنكم الاطلاع على تفاصيل خيارات التكامل التقني والشروط والأحكام الحالية مباشرةً على [اسم الموقع الإلكتروني/المنصة]. صفحة المنصة.

Empfehlungen

طلب تحليل التصدير

اتصل بنا الآن!

+49 (0) 341 -249 691 84

لا يمكن قراءة بيانات النموذج المنشورة.

اتصل بنا الآن!

+49 (0) 341 -249 691 84