خطافات الويب (Webhooks) مقابل واجهات برمجة التطبيقات (APIs): متى تستخدم كلاً منهما؟

في عالم البرمجيات الحديث، نادرًا ما تعمل التطبيقات بشكل مستقل. فالمواقع الإلكترونية وتطبيقات الهاتف ومنصات الدفع وأنظمة CRM ومتاجر التجارة الإلكترونية وأنظمة ERP والخدمات السحابية تحتاج باستمرار إلى تبادل البيانات فيما بينها.

ومن أكثر التقنيات استخدامًا لتحقيق هذا التواصل واجهات برمجة التطبيقات APIs وWebhooks.

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

لذلك، فإن فهم الفرق بين Webhooks وAPIs يساعد المطورين والشركات على بناء تكاملات أسرع وأكثر كفاءة وموثوقية.

ما هي API؟

اختصار API يعني Application Programming Interface، أي واجهة برمجة التطبيقات.

وهي طريقة منظمة تسمح لتطبيقات وبرامج مختلفة بالتواصل مع بعضها البعض. يمكن لتطبيق معين استخدام API لطلب معلومات أو تنفيذ عملية يوفرها نظام آخر.

على سبيل المثال، يمكن لمتجر إلكتروني استخدام API لطلب بيانات العملاء من نظام CRM. يرسل المتجر طلبًا إلى النظام، ثم تتم معالجة الطلب وإرجاع البيانات المطلوبة.

عادةً ما تعمل عملية API بالشكل التالي:

1. يرسل التطبيق الأول طلبًا.
2. يستقبل التطبيق أو الخادم الآخر الطلب.
3. تتم معالجة الطلب.
4. يتم إرسال استجابة تحتوي على البيانات أو نتيجة العملية.

يمكن بناء APIs باستخدام تقنيات وأساليب مختلفة، مثل REST وGraphQL وSOAP وغيرها.

ما هو Webhook؟

Webhook هو آلية تعتمد على الأحداث تسمح لنظام بإرسال البيانات تلقائيًا إلى نظام آخر عند حدوث حدث معين.

بدلًا من أن يقوم التطبيق باستمرار بسؤال نظام آخر عما إذا كان حدث معين قد وقع، يقوم النظام المصدر بإرسال إشعار تلقائي عند حدوث الحدث.

عادةً ما يوفر التطبيق المستقبل عنوان URL يُعرف باسم Webhook Endpoint. وعندما يحدث الحدث، يرسل النظام المصدر طلب HTTP إلى هذا العنوان مع بيانات الحدث.

على سبيل المثال، عندما تتم عملية دفع ناجحة في متجر إلكتروني، يمكن لمنصة الدفع إرسال Webhook إلى خادم المتجر لإبلاغه بأن عملية الدفع قد اكتملت.

يعمل Webhook عادةً بالشكل التالي:

1. يحدث حدث معين.
2. يكتشف النظام المصدر الحدث.
3. يرسل النظام طلب HTTP إلى Webhook URL.
4. يستقبل النظام الآخر الحدث ويقوم بمعالجته.

Webhooks مقابل APIs: ما الفرق الأساسي؟

أسهل طريقة لفهم الفرق هي معرفة من يبدأ عملية التواصل.

العنصر	API	Webhook
طريقة التواصل	طلب واستجابة	تواصل يعتمد على الأحداث
من يبدأ الاتصال؟	التطبيق العميل	النظام المصدر
متى يتم إرسال البيانات؟	عند طلبها	عند حدوث حدث معين
الاتجاه المعتاد	العميل يطلب من الخادم	الخادم يرسل الحدث إلى Endpoint
الإشعارات الفورية	قد تحتاج إلى طلبات متكررة	مناسبة جدًا
الحاجة إلى Polling	قد تكون مطلوبة	لا
الاستخدام الأفضل	طلب البيانات وتنفيذ العمليات	الإشعارات المعتمدة على الأحداث

مثال بسيط على الفرق

لنفترض أن لديك متجرًا إلكترونيًا وتحتاج إلى معرفة ما إذا كان العميل قد أكمل عملية الدفع.

استخدام API

يمكن للمتجر أن يرسل طلبًا إلى منصة الدفع بشكل متكرر:

"هل تمت عملية الدفع؟"

وتقوم منصة الدفع بإرسال استجابة في كل مرة.

هذا الأسلوب يسمى Polling، أي الاستعلام المتكرر عن حالة معينة.

استخدام Webhook

بدلًا من إرسال الطلبات باستمرار، يقوم المتجر بتوفير Webhook URL لمنصة الدفع.

عندما تتم عملية الدفع بنجاح، ترسل منصة الدفع إشعارًا تلقائيًا:

نجاح الدفع → Webhook → تحديث حالة الطلب

وبذلك لا يحتاج المتجر إلى الاستعلام باستمرار عن حالة الدفع.

متى يجب استخدام API؟

تكون API مناسبة عندما يحتاج التطبيق إلى طلب معلومات محددة أو تنفيذ عملية معينة.

1. الحصول على البيانات

يمكن استخدام API عندما يحتاج التطبيق إلى بيانات العملاء أو المنتجات أو الطلبات أو المخزون أو الموظفين.

2. إنشاء أو تحديث البيانات

تُستخدم APIs أيضًا لإنشاء أو تعديل أو حذف البيانات في نظام آخر.

على سبيل المثال:

• إنشاء عميل جديد في CRM.
• تحديث بيانات منتج.
• إنشاء فاتورة.
• تحديث حالة طلب.
• الحصول على مستوى المخزون.

3. تنفيذ العمليات عند الطلب

إذا قام المستخدم بالنقر على زر داخل التطبيق وكان التطبيق بحاجة إلى تنفيذ عملية مباشرة، فإن API غالبًا تكون الخيار المناسب.

4. الاستعلامات المعقدة

يمكن استخدام APIs عندما يحتاج التطبيق إلى تحديد البيانات التي يريد الحصول عليها بدقة.

على سبيل المثال، يمكن للوحة تحكم أن تطلب بيانات المبيعات لعميل محدد أو فترة زمنية معينة أو منطقة محددة أو مجموعة من المنتجات.

متى يجب استخدام Webhook؟

تكون Webhooks مناسبة عندما يحتاج التطبيق إلى الاستجابة تلقائيًا لحدث معين.

1. إشعارات الدفع

يمكن لمنصات الدفع إرسال Webhooks عند حدوث أحداث مثل:

• نجاح عملية الدفع.
• فشل عملية الدفع.
• إنشاء عملية استرداد.
• تغيير حالة الاشتراك.

2. تحديثات الطلبات

يمكن لمنصة التجارة الإلكترونية إرسال Webhook عند إنشاء طلب أو إلغائه أو شحنه أو تحديثه.

3. أحداث CRM

يمكن لنظام CRM إرسال Webhook إلى تطبيق آخر عند إنشاء عميل محتمل أو فرصة مبيعات أو عند تغيير بيانات العميل.

4. عمليات التطوير البرمجي

يمكن لمنصات تطوير البرمجيات استخدام Webhooks لإرسال إشعارات عند رفع كود جديد أو إنشاء Pull Request أو حدوث تغييرات في المستودع البرمجي.

5. الإشعارات شبه الفورية

عندما يحتاج النظام إلى معرفة حدوث حدث معين في أقرب وقت ممكن، يمكن أن تكون Webhooks أكثر كفاءة من الاستعلام المتكرر باستخدام API.

API Polling مقابل Webhooks

من أهم المقارنات التي يجب فهمها الفرق بين Polling باستخدام API وWebhooks.

في حالة Polling، يرسل التطبيق طلبات متكررة:

طلب → لا يوجد حدث جديد → انتظار → طلب مرة أخرى

إذا حدثت العملية بين فترات الاستعلام، فقد لا يكتشف التطبيق الحدث مباشرة.

أما باستخدام Webhook:

حدث → إرسال إشعار → استقبال التطبيق للحدث → معالجة الحدث

وبالتالي يمكن تقليل الطلبات غير الضرورية وتحسين سرعة اكتشاف الأحداث.

مميزات APIs

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

مميزات Webhooks

• تعتمد على الأحداث.
• مناسبة للإشعارات شبه الفورية.
• تقلل الحاجة إلى Polling المستمر.
• مناسبة للتكاملات القائمة على الأحداث.
• مفيدة في أتمتة العمليات.
• يمكن أن تقلل عدد طلبات API غير الضرورية.

تحديات استخدام APIs

• يمكن أن يؤدي Polling المتكرر إلى زيادة عدد الطلبات.
• قد تفرض الخدمات حدودًا على عدد الطلبات.
• يجب على التطبيق معرفة الوقت المناسب لطلب البيانات المحدثة.
• يمكن أن يؤدي الاستخدام المكثف إلى زيادة الحمل على الخادم والشبكة.

تحديات استخدام Webhooks

Webhooks ليست أفضل في جميع الحالات، فهي تتطلب أيضًا بعض الاعتبارات التقنية.

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

الأمان عند استخدام APIs وWebhooks

يجب التعامل مع الأمان كجزء أساسي من تصميم أي تكامل بين الأنظمة.

أمان API

يمكن حماية APIs باستخدام وسائل مختلفة مثل مفاتيح API وOAuth 2.0 وAccess Tokens وآليات المصادقة والتفويض الأخرى.

كما يجب استخدام HTTPS والتحقق من البيانات المدخلة وتطبيق Rate Limiting وتقييد الصلاحيات وفق مبدأ أقل صلاحية ممكنة.

أمان Webhooks

يجب ألا يثق التطبيق بشكل مباشر في أي طلب Webhook وارد.

يمكن استخدام مجموعة من تقنيات الحماية، حسب مزود الخدمة، مثل:

• التحقق من التوقيع الرقمي للطلب.
• استخدام Shared Secrets.
• HTTPS.
• قوائم IP المسموح بها عند الحاجة.
• التحقق من Timestamp.
• الحماية من إعادة إرسال الطلبات Replay Attacks.

كما يجب التحقق من محتوى الحدث قبل تنفيذ أي عملية بناءً عليه.

هل يمكن استخدام API وWebhook معًا؟

نعم، وبشكل شائع جدًا.

في العديد من التكاملات الحديثة، يتم استخدام Webhook لإبلاغ التطبيق بحدوث حدث، ثم يتم استخدام API للحصول على بيانات إضافية أو تنفيذ إجراء معين.

على سبيل المثال:

1. يقوم العميل بإنشاء طلب.
2. ترسل منصة التجارة الإلكترونية Webhook.
3. يستقبل التطبيق الحدث.
4. يتحقق التطبيق من صحة الحدث.
5. يستخدم التطبيق API للحصول على تفاصيل الطلب الكاملة.
6. يقوم التطبيق بتحديث قاعدة البيانات الخاصة به.

يساعد هذا الأسلوب على الجمع بين سرعة الإشعارات المعتمدة على الأحداث والمرونة التي توفرها APIs.

Webhooks مقابل APIs: أمثلة عملية

حالة الاستخدام	الخيار المناسب
الحصول على بيانات العميل	API
إنشاء طلب جديد	API
فحص المخزون عند الطلب	API
استقبال إشعار نجاح الدفع	Webhook
استقبال إشعار إنشاء طلب	Webhook
إشعار النظام بوجود Lead جديد	Webhook
الحصول على بيانات إضافية بعد حدث	Webhook + API
تحديث سجل بناءً على إجراء المستخدم	API

كيف تختار بين Webhook وAPI؟

يمكنك طرح سؤال بسيط:

"هل أحتاج إلى طلب المعلومات، أم أحتاج إلى أن يتم إخباري عندما يحدث شيء معين؟"

إذا كنت تحتاج إلى طلب معلومات أو تنفيذ عملية، فاستخدم API.

إذا كنت تحتاج إلى استقبال إشعار عند حدوث حدث معين، فاستخدم Webhook.

إذا كنت تحتاج إلى الأمرين معًا، فاستخدم API وWebhook معًا.

Webhooks وAPIs في التطبيقات الحديثة

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

توفر APIs وصولًا منظمًا إلى البيانات والوظائف، بينما توفر Webhooks طريقة تعتمد على الأحداث لإرسال الإشعارات بين الأنظمة.

ولهذا يمكن أن تستخدم البنية الحديثة APIs لتنفيذ الأوامر والحصول على البيانات، بينما تستخدم Webhooks لإرسال إشعارات الأحداث بشكل غير متزامن.

الخلاصة

APIs وWebhooks ليستا تقنيتين متنافستين. بل هما تقنيتان متكاملتان تستخدمان في سيناريوهات مختلفة.

استخدم API عندما يحتاج التطبيق إلى طلب البيانات أو إنشاء أو تحديث السجلات أو تنفيذ عملية معينة.

استخدم Webhook عندما يحتاج التطبيق إلى استقبال إشعار تلقائي عند حدوث حدث معين.

وفي العديد من التكاملات الواقعية، يكون الحل الأفضل هو استخدام APIs وWebhooks معًا. حيث يقوم Webhook بإخبار التطبيق بأن شيئًا ما قد حدث، بينما توفر API البيانات أو العملية اللازمة لإكمال سير العمل.

ببساطة: API تسمح لك بأن تسأل، بينما Webhook يسمح لنظام آخر بأن يخبرك.