البدء السريع
احصل على إشعارات فورية عند حدوث الأخبار العاجلة. تُسلّم webhooks تحديثات المقالات في الوقت الفعلي مباشرةً إلى تطبيقك، مما يلغي الحاجة إلى استطلاع API باستمرار.
ما هي webhooks؟
فكّر في webhooks على أنها إشعارات فورية لتطبيقك. عند ظهور خبر يطابق معاييرك، يرسل finlight بيانات المقال فورًا إلى نقطة النهاية التي حدّدتها.
كيف تعمل webhooks
إليك التدفّق الكامل بعبارات بسيطة:
- التهيئة - أعدّ webhook الخاص بك بمعايير أخبار محدّدة
- المراقبة - يراقب نظامنا المقالات الجديدة على مدار الساعة طوال أيام الأسبوع
- المطابقة - عندما يستوفي مقال معاييرك، نكتشفه فورًا
- التسليم - نرسل بيانات المقال مباشرةً إلى نقطة النهاية الخاصة بك
يعني هذا النهج المعروف بـ "API العكسي" أن تطبيقك يتلقّى التحديثات لحظة حدوثها، بدلًا من طلبها بشكل متكرّر.
البدء
ما ستحتاج إليه
قبل إنشاء أول webhook، تأكّد من توفّر:
- اشتراك finlight نشط مع إمكانية الوصول إلى webhook
- نقطة نهاية HTTPS عامة جاهزة لاستقبال استدعاءات webhook
- إمكانية الوصول إلى لوحة التحكم على app.finlight.me
وصول سريع
انتقل مباشرةً إلى إنشاء webhook بزيارة app.finlight.me/news-webhooks وتسجيل الدخول إلى حساب finlight الخاص بك.
إنشاء أول webhook لك
اتّبع هذه العملية البسيطة المكوّنة من 4 خطوات لإعداد webhook والبدء في تلقّي تحديثات الأخبار في الوقت الفعلي.
الخطوة 1: الوصول إلى أداة إنشاء Webhook
- سجّل الدخول إلى لوحة تحكم finlight على app.finlight.me
- انتقل إلى "Webhooks" في القائمة الرئيسية
- انقر على "New Webhook" لتشغيل معالج الإعداد
الخطوة 2: التفاصيل الأساسية
امنح webhook هويةً واضحة واختر نوع التسليم:
- الاسم - اختر اسمًا وصفيًا مثل "أخبار التقنية العاجلة" أو "تحديثات السوق"
- الوصف - شرح موجز اختياري للغرض من webhook
- نوع التسليم - اختر كيفية تسليم المقالات:
- مُثرى (افتراضي) — حمولة معالَجة بالذكاء الاصطناعي تتضمّن بيانات الشركة والمشاعر وخيارات التصفية الكاملة. راجع دليل Webhooks المُثراة.
- خام — تسليم أسرع، وحمولة مبسّطة، ومرشّحات محدودة. راجع دليل Webhooks الخام.
الخطوة 3: حدّد معايير الأخبار الخاصة بك
هيّئ التصفية لتلقّي المقالات ذات الصلة فقط. تعتمد الخيارات المتاحة على نوع التسليم الذي اخترته.
راجع Webhooks المُثراة أو Webhooks الخام للحصول على مرجع التصفية الكامل لنوعك.
الخطوة 4: ضبط الوجهة والأمان
وجهة Webhook
قدّم عنوان URL لنقطة النهاية الخاصة بك حيث سنرسل الأخبار:
- يجب أن يكون عنوان URL عامًا بـ HTTPS
- ينبغي أن يستجيب بسرعة (أقل من 5 ثوانٍ)
إعداد الأمان
اختر كيفية تأمين نقطة نهاية webhook الخاصة بك:
- بلا - دون مصادقة إضافية (غير موصى به للإنتاج)
- المصادقة الأساسية - حماية باسم المستخدم/كلمة المرور عبر HTTP Basic Auth
- ترويسة مخصّصة - أرسل مفتاح API الخاص بك في ترويسة
X-Finlight-Key - التحقّق من التوقيع - مُضمَّن دائمًا للتحقّق من الحمولة عبر ترويسة
X-Webhook-Signature
ملاحظة: يتم تفعيل التحقّق من التوقيع تلقائيًا على جميع webhooks للتحقّق من سلامة الحمولة، بغضّ النظر عن طريقة المصادقة التي اخترتها.
تعرّف أكثر على كيفية تطبيق خيارات الأمان هذه في دليل المصادقة الخاص بنا.
اختبار الدمج الخاص بك
أدوات اختبار مدمجة
قبل الانتقال إلى الإنتاج، تحقّق من إعداد webhook الخاص بك:
- ميزة الاختبار في لوحة التحكم - أرسل حمولات نموذجية إلى نقطة النهاية الخاصة بك
- مراقبة التسليم - تتبّع معدّلات النجاح وأوقات الاستجابة
- تشخيص الأخطاء - صحّح عمليات التسليم الفاشلة
للاطّلاع على تعليمات اختبار شاملة وأمثلة على الحمولة ونصائح استكشاف الأخطاء، راجع دليل اختبار webhook الخاص بنا.
هل تحتاج إلى مساعدة؟
خيارات الدعم السريع
الحمولة والتصفية
راجع Webhooks المُثراة أو Webhooks الخام للاطّلاع على نموذج المقال ومرجع التصفية لنوعك.
الإعداد التقني
راجع دليل المصادقة ودليل الاختبار للحصول على مساعدة تفصيلية في التطبيق.
الدعم العام
راجع صفحة الدعم للحصول على موارد إضافية ومعلومات التواصل.
مشكلات لوحة التحكم
ادخل إلى إدارة webhook الخاصة بك على app.finlight.me أو تواصل مع الدعم عبر المنصّة.
هل أنت مستعدّ للبدء؟
تُحوّل webhooks طريقة تلقّيك لتحديثات الأخبار - من الاستطلاع كل بضع دقائق إلى التسليم الفوري لحظة ظهور الخبر.
ابدأ ببساطة بمعايير تصفية أساسية، ثم وسّع تدريجيًا كلما اكتشفت ما يناسب تطبيقك على أفضل وجه. تتيح لك لوحة تحكم finlight تعديل webhooks وتحسينها بسهولة في أي وقت.