Webhooks الخام

تُعدّ Webhooks الخام بديلًا خفيفًا وسريع التسليم لـ webhooks القياسية (المُثراة). فهي تسلّم بيانات المقال الأساسية لحظة نشره، متخطّيةً مسار الإثراء بالذكاء الاصطناعي بالكامل.

الفروق الرئيسية عن Webhooks المُثراة:

تسليم أسرع — تُدفَع المقالات فور استيعابها، دون انتظار تحليل المشاعر أو حل الكيانات أو مطابقة الشركات.
مرشّحات مبسّطة — لا يُدعَم سوى query وsources وexcludeSources وlanguage وincludeUpdates. أما tickers وcountries وcategories وincludeContent وincludeEntities وexcludeEmptyContent فغير متاحة.
دون إثراء بالذكاء الاصطناعي — لا تحتوي الحمولات على بيانات sentiment أو confidence أو companies.
تصفية query على مستوى الحقول — يدعم المعامل query صياغة مستوى الحقول لـ source وtitle وsummary فقط.
نوع غير قابل للتغيير — يُحدَّد نوع التسليم (raw أو enriched) عند الإنشاء ولا يمكن تغييره بعد ذلك.

نموذج المقال

تسلّم Webhooks الخام حمولة مقال مبسّطة. لا تُضمَّن أي كيانات شركات أو درجات مشاعر أو إثراءات مُولَّدة بالذكاء الاصطناعي.

Name
link
Type
string
Description
عنوان URL للمقال الكامل.
Name
source
Type
string
Description
موقع المصدر. مثل www.reuters.com
Name
title
Type
string
Description
عنوان المقال.
Name
summary
Type
string
Description
ملخّص المقال إن وُجد. يمكن أن يكون فارغًا (nullable).
Name
publishDate
Type
Date
Description
تاريخ النشر كسلسلة تاريخ بصيغة ISO 8601.
Name
createdAt
Type
Date
Description
تاريخ الإنشاء الداخلي للمقال في نظام finlight كسلسلة تاريخ بصيغة ISO 8601.
Name
revisedDate
Type
Date | null
Description
تاريخ آخر مراجعة للمقال بعد النشر الأولي. يكون null عندما لا يُراجَع المقال قطّ. يظهر عند تفعيل includeUpdates ومراجعة المقال.
Name
isUpdate
Type
boolean
Description
يكون true عندما يُطلَق هذا التسليم بسبب تحديث بعد النشر. يظهر فقط عند تفعيل includeUpdates.
Name
language
Type
string
Description
رمز اللغة بصيغة ISO 639-1. مثل en | de | fr
Name
images
Type
string[]
Description
مصفوفة عناوين URL لصور المقال.
Name
countries
Type
string[]
Description
مصفوفة رموز الدول بصيغة ISO 3166-1 alpha-2. مثل ["US", "GB"]. يمكن أن تكون فارغة.
Name
categories
Type
string[]
Description
مصفوفة فئات المقال. القيم الممكنة: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security. يمكن أن تكون فارغة.

WEBHOOKنوع التسليم

إنشاء Webhook خام

عند إنشاء webhook في لوحة تحكم finlight، اختر Raw كنوع للتسليم في الخطوة الأولى من معالج الإعداد. عندئذٍ ستعرض خطوة المعايير المعاملات الأربعة المدعومة فقط.

تسلّم Webhooks الخام فقط المقالات المنشورة حديثًا التي تطابق معاييرك. وكل تسليم هو حمولة مقال واحد تُرسَل كطلب HTTP POST إلى نقطة النهاية الخاصة بك.

Name
query
Type
string
Description
استعلام البحث للعثور على المقالات ذات الصلة. يدعم التصفية على مستوى الحقول لـ source وtitle وsummary. راجع تصفية query على مستوى الحقول أدناه.
Name
sources
Type
string[]
Description
يقصر التسليم على مقالات من مصادر محدّدة. مثل ["www.reuters.com", "www.cnbc.com"]. راجع نقطة نهاية المصادر للقيم الصالحة.
Name
excludeSources
Type
string[]
Description
يستبعد المقالات من مصادر محدّدة. مثل ["www.example.com"].
Name
language
Type
string
Description
التصفية حسب لغة المقال (ISO 639-1). القيمة الافتراضية هي en، التي تُرجع الإنجليزية فقط وتستبعد اللغات الأخرى — راجع اللغة والتغطية.
Name
includeUpdates
Type
boolean
Description
يعيد تسليم المقالات عند تحديثها بعد النشر الأولي. تتضمّن الحمولات المُحدَّثة isUpdate=true وطابعًا زمنيًا revisedDate.

Response

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs",
  "summary": "A brief summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "language": "en",
  "images": [
    "https://www.example.com/image1.jpg",
    "https://www.example.com/image2.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"]
}

Response (includeUpdates: true)

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs — Updated",
  "summary": "An updated summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "revisedDate": "2023-10-02T08:00:00Z",
  "isUpdate": true,
  "language": "en",
  "images": [
    "https://www.example.com/image1.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"]
}

تصفية query على مستوى الحقول

يدعم المعامل query في Webhooks الخام التصفية على مستوى الحقول المقتصرة على هذه الحقول فقط:

source - التصفية حسب نطاق مصدر المقال
title - التصفية حسب محتوى عنوان المقال
summary - التصفية حسب محتوى ملخّص المقال

أمثلة:

query=title:Nvidia

يسلّم المقالات التي يحتوي عنوانها على «Nvidia».

query=summary:earnings +title:Tesla

يسلّم المقالات التي يذكر ملخّصها «earnings» ويحتوي عنوانها على «Tesla».

query=source:www.reuters.com -crypto

يسلّم مقالات Reuters، مع استبعاد ما يذكر «crypto».

راجع دليل إنشاء الاستعلامات المتقدمة للحصول على المرجع الكامل لصياغة الاستعلام.

GUIDEمساعدة على القرار

متى تستخدم Webhooks الخام

اختر Raw عندما:

تحتاج إلى أقل زمن تسليم ممكن
تبني مسارًا عالي الإنتاجية لا تحتاج فيه إلى بيانات الإثراء
يكفيك التصفية حسب الكلمات المفتاحية أو المصادر أو اللغة فقط
ترغب في حمولة أخفّ لتقليل عبء المعالجة لديك

اختر Enriched عندما:

تحتاج إلى تصفية على مستوى الشركة/الرمز (tickers وcountries وcategories)
ترغب في درجات المشاعر أو قيم الثقة أو حل الكيانات داخل الحمولة
تحتاج إلى تضمين محتوى المقال الكامل أو الكيانات المستخرجة عبر includeContent / includeEntities
تبني مراقبة للأسهم أو تتبّعًا للأرباح أو خلاصات أخبار خاصة بقطاع معيّن

للاطّلاع على التفاصيل الكاملة لخيارات تصفية webhook المُثرى، راجع دليل معايير التصفية.