نظرة عامة
تتيح لك Webhooks استقبال إشعار HTTP POST على نقطة النهاية (endpoint) الخاصة بك في كل مرة يكتمل فيها تحويل. استخدمها لتشغيل سير عمل في Zapier أو Make أو n8n أو أي خادم خلفي مخصص.Webhooks ميزة متاحة في خطة PRO. يمكن لكل مستخدم تسجيل ما يصل إلى 3 نقاط نهاية Webhook.
الإعداد
- افتح إضافة Web2MD وانتقل إلى الإعدادات (Settings).
- مرّر إلى قسم Webhooks.
- أدخل رابط نقطة النهاية الخاصة بك وانقر على إضافة Webhook.
- انسخ مفتاح التوقيع السري (signing secret) — ستحتاجه للتحقق من الطلبات الواردة.
الحمولة (Payload)
عند اكتمال تحويل، يرسل Web2MD طلبPOST إلى نقطة النهاية الخاصة بك مع محتوى JSON التالي:
الأمان
يتضمن كل طلب webhook ترويسةX-Web2MD-Signature تحتوي على توقيع HMAC-SHA256 لجسم الطلب الخام، موقَّع بمفتاح التوقيع السري الخاص بـ webhook الخاص بك.
مثال على التحقق (Node.js)
سلوك إعادة المحاولة
إذا فشلت كلتا المحاولتين (استجابة غير 2xx أو انتهاء مهلة)، يُسقط التسليم. لا يعيد Web2MD المحاولة بعد محاولة إعادة المحاولة الواحدة.
حالات الاستخدام
Zapier / Make / n8n
استخدم مشغّل Webhook في منصة الأتمتة الخاصة بك لبدء سير عمل كلما تم تحويل صفحة — أرسل إلى Slack، أضف صفًا إلى جدول بيانات، أو احفظ إلى Notion.
إشعارات Slack
أرسل رسالة إلى قناة Slack في كل مرة يحوّل فيها أحد أعضاء الفريق صفحة، مما يبقي الجميع على اطّلاع.
حفظ تلقائي في تخزين خارجي
اجلب Markdown الكامل عبر REST API (باستخدام
conversionId) واحفظه في S3 أو Google Drive أو قاعدة بياناتك الخاصة.خط معالجة التحليلات
تتبّع حجم التحويلات وأنواع المحتوى عن طريق إعادة توجيه أحداث webhook إلى الخادم الخلفي للتحليلات الخاص بك.