Webhooks المُثراة

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

القدرات الرئيسية لـ Webhooks المُثراة:

تصفية كاملة — التصفية حسب الرموز والدول والفئات والمصادر واللغة وquery
إثراء بالذكاء الاصطناعي — تتضمّن الحمولات درجات المشاعر ومطابقات الشركات وقيم الثقة
محتوى مرن — يمكنك اختياريًا تضمين نص المقال الكامل والكيانات المستخرجة عبر includeContent / includeEntities
نوع غير قابل للتغيير — يُحدَّد نوع التسليم (enriched أو raw) عند الإنشاء ولا يمكن تغييره بعد ذلك

نموذج المقال

تسلّم 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
sentiment
Type
string
Description
مشاعر المقال المُولَّدة بالذكاء الاصطناعي. القيم الممكنة: positive | negative | neutral.
Name
confidence
Type
number
Description
درجة الثقة لقيمة المشاعر، بين 0 و1.
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. يمكن أن تكون فارغة.
Name
companies
Type
Company[]
Description
مصفوفة من كائنات الشركات المطابِقة المحلولة بمطابقة الكيانات بالذكاء الاصطناعي. تحتوي كل شركة على الحقول التالية:
- companyId number — معرّف الشركة الداخلي في finlight
- confidence string — درجة ثقة مطابقة الكيان
- name string — الاسم الكامل للشركة
- ticker string — رمز التداول الأساسي. مثل AAPL
- exchange string — رمز البورصة. مثل XNAS
- country string — بلد الإدراج الأساسي (ISO 3166-1 alpha-2)
- sector string — تصنيف القطاع. مثل Technology
- industry string — تصنيف الصناعة
- isin string — رمز ISIN الأساسي
- openfigi string — معرّف OpenFIGI
- primaryListing object — { ticker, exchangeCode, exchangeCountry }
- isins string[] — جميع رموز ISIN المعروفة للشركة
- otherListings object[] — [{ ticker, exchangeCode, exchangeCountry }]

WEBHOOKنوع التسليم

إنشاء Webhook مُثرى

عند إنشاء webhook في لوحة تحكم finlight، اختر Enriched كنوع للتسليم في الخطوة الأولى من معالج الإعداد. وهذا هو الخيار الافتراضي. وستعرض خطوة المعايير جميع معاملات التصفية المتاحة.

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

Name
query
Type
string
Description
استعلام البحث للعثور على المقالات ذات الصلة. يدعم العوامل المنطقية والتصفية على مستوى الحقول. راجع دليل إنشاء الاستعلامات المتقدمة.
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
tickers
Type
string[]
Description
التصفية حسب رموز التداول. لن تُسلَّم سوى المقالات المطابَقة لهذه الشركات عبر حل الكيانات بالذكاء الاصطناعي. مثل ["AAPL", "GOOGL", "TSLA"].
Name
countries
Type
string[]
Description
التصفية حسب رموز الدول (ISO 3166-1 alpha-2). لن تُسلَّم سوى المقالات المطابَقة لشركات من هذه الدول. مثل ["US", "GB", "DE"].
Name
categories
Type
string[]
Description
التصفية حسب فئة المقال. القيم الممكنة: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security.
Name
includeContent
Type
boolean
Description
يتضمّن النص الكامل لجسم المقال في الحمولة. يتطلّب باقة تتيح الوصول إلى المقال الكامل.
Name
includeEntities
Type
boolean
Description
يتضمّن الكيانات المستخرجة (الشركات والأشخاص والمواقع) الموجودة في المقال.
Name
excludeEmptyContent
Type
boolean
Description
يسلّم فقط المقالات التي لها ملخّص غير فارغ. مفيد لتصفية المقالات منخفضة الجودة.
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",
  "sentiment": "positive",
  "confidence": 0.95,
  "images": [
    "https://www.example.com/image1.jpg",
    "https://www.example.com/image2.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets", "health"],
  "companies": [
    {
      "companyId": 41494,
      "confidence": "0.9335401058197021",
      "country": "US",
      "exchange": "XNAS",
      "industry": "Biotechnology: Pharmaceutical Preparations",
      "name": "Summit Therapeutics Inc. Common Stock",
      "sector": "Health Care",
      "ticker": "SMMT",
      "isin": "US86627T1088",
      "openfigi": "BBG01PH11VP5",
      "primaryListing": {
        "ticker": "SMMT",
        "exchangeCode": "XNAS",
        "exchangeCountry": "US"
      },
      "isins": ["US86627T1088", "US86627T2088"],
      "otherListings": [
        {
          "ticker": "SMMT.L",
          "exchangeCode": "XLON",
          "exchangeCountry": "GB"
        }
      ]
    }
  ]
}

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",
  "sentiment": "positive",
  "confidence": 0.95,
  "images": [
    "https://www.example.com/image1.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"],
  "companies": []
}

EXAMPLESمرشّحات مجمَّعة

أمثلة التصفية

تدعم Webhooks المُثراة الجمع بين جميع معاملات التصفية. إليك أنماطًا شائعة:

خلاصة بحث الشركات:

tickers: ["AAPL", "GOOGL"]
sources: ["www.reuters.com", "www.bloomberg.com"]
includeEntities: true

أخبار السوق العاجلة:

query: "earnings OR revenue OR guidance"
categories: ["markets", "economy"]
language: "en"

التركيز الإقليمي على قطاع معيّن:

countries: ["US", "CA"]
query: "tech OR technology OR semiconductor"
tickers: ["NVDA", "TSMC", "AMD"]

الأخبار المالية الأوروبية:

countries: ["GB", "DE", "FR"]
sources: ["www.reuters.com", "www.ft.com"]
language: "en"

تدعم صياغة الاستعلام العوامل المنطقية والعبارات بين علامات اقتباس والاستبعاد:

"Apple earnings"                           simple phrase
(Apple OR iPhone) AND (earnings OR revenue)  boolean groups
Tesla NOT recall                           exclusion

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

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

متى تستخدم Webhooks المُثراة

اختر Enriched عندما:

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

اختر Raw عندما:

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

للاطّلاع على التفاصيل الكاملة لخيارات تصفية Webhook الخام، راجع دليل Webhooks الخام.