الانتقال إلى المحتوى الرئيسي

نظرة عامة

تتيح لك Webhooks استقبال إشعار HTTP POST على نقطة النهاية (endpoint) الخاصة بك في كل مرة يكتمل فيها تحويل. استخدمها لتشغيل سير عمل في Zapier أو Make أو n8n أو أي خادم خلفي مخصص.
Webhooks ميزة متاحة في خطة PRO. يمكن لكل مستخدم تسجيل ما يصل إلى 3 نقاط نهاية Webhook.

الإعداد

  1. افتح إضافة Web2MD وانتقل إلى الإعدادات (Settings).
  2. مرّر إلى قسم Webhooks.
  3. أدخل رابط نقطة النهاية الخاصة بك وانقر على إضافة Webhook.
  4. انسخ مفتاح التوقيع السري (signing secret) — ستحتاجه للتحقق من الطلبات الواردة.

الحمولة (Payload)

عند اكتمال تحويل، يرسل Web2MD طلب POST إلى نقطة النهاية الخاصة بك مع محتوى JSON التالي:

الأمان

يتضمن كل طلب webhook ترويسة X-Web2MD-Signature تحتوي على توقيع HMAC-SHA256 لجسم الطلب الخام، موقَّع بمفتاح التوقيع السري الخاص بـ webhook الخاص بك.
تحقّق دائمًا من التوقيع قبل معالجة أي webhook. هذا يمنع المهاجمين من إرسال طلبات مزوَّرة إلى نقطة النهاية الخاصة بك.

مثال على التحقق (Node.js)

استخدم crypto.timingSafeEqual بدلًا من === لمنع هجمات التوقيت (timing attacks) عند مقارنة التوقيعات.

سلوك إعادة المحاولة

إذا فشلت كلتا المحاولتين (استجابة غير 2xx أو انتهاء مهلة)، يُسقط التسليم. لا يعيد Web2MD المحاولة بعد محاولة إعادة المحاولة الواحدة.

حالات الاستخدام

Zapier / Make / n8n

استخدم مشغّل Webhook في منصة الأتمتة الخاصة بك لبدء سير عمل كلما تم تحويل صفحة — أرسل إلى Slack، أضف صفًا إلى جدول بيانات، أو احفظ إلى Notion.

إشعارات Slack

أرسل رسالة إلى قناة Slack في كل مرة يحوّل فيها أحد أعضاء الفريق صفحة، مما يبقي الجميع على اطّلاع.

حفظ تلقائي في تخزين خارجي

اجلب Markdown الكامل عبر REST API (باستخدام conversionId) واحفظه في S3 أو Google Drive أو قاعدة بياناتك الخاصة.

خط معالجة التحليلات

تتبّع حجم التحويلات وأنواع المحتوى عن طريق إعادة توجيه أحداث webhook إلى الخادم الخلفي للتحليلات الخاص بك.

اختبار Webhooks

أثناء التطوير، استخدم أداة مثل webhook.site أو ngrok لكشف نقطة نهاية محلية ومعاينة الحمولات الواردة قبل نشر معالجك في بيئة الإنتاج.