تمت ترجمة هذه الصفحة آليًا. النسخة الإنجليزية هي المصدر وقد تكون أكثر دقة أو أحدث. العرض بالإنجليزية

بناء الاستعلامات المتقدمة

عند العمل مع واجهة finlight.me API، تتيح لك تقنيات بناء الاستعلامات المتقدمة استرجاع البيانات التي تحتاجها بالضبط. يرشدك هذا الدليل خطوة بخطوة عبر التصفية المعقدة والفرز والترقيم، مما يساعدك على تحسين عملية استرجاع البيانات.

استخدم لوحة التحكم - أداة اختبار API للوصول السريع إلى واجهة API واختبار استعلاماتك.

اللغة والنطاق متعدد اللغات

تفهرس finlight الأخبار بـ لغات متعددة، لكن كل طلب يُصفّى حسب لغة واحدة. القيمة الافتراضية لمعامل language هي en، لذا إن لم تُحدده ستحصل على مقالات بالإنجليزية فقط — ويُستبعد المحتوى باللغات الأخرى بصمت.

مهم: القيمة الافتراضية لـ language هي en. الطلب بدون language يُرجع الإنجليزية فقط. المقالات المنشورة بلغات أخرى (مثل العديد من المنصات الصينية، zh) لا تُرجَع ما لم تطلب تلك اللغة صراحةً.

كيف يعمل ذلك

  • مستوى المقال، تطابق تام. يُصفّي language حسب رمز ISO 639-1 لكل مقال كتطابق تام. يُرجع language=en مقالات en فقط ولا يُرجع أبداً de أو zh وما إلى ذلك.
  • لغة واحدة لكل طلب. يقبل language قيمة واحدة — المصفوفات/القوائم المفصولة بفواصل غير مدعومة، ولا يوجد خيار «كل اللغات». لتغطية لغات متعددة، أرسل طلباً واحداً لكل لغة ثم ادمج النتائج.
  • قد تكون المصادر متعددة اللغات. قد ينشر مصدر واحد بأكثر من لغة. يختار المرشّح حسب لغة المقال، لا المصدر. لن تظهر مقالات المنصة غير الإنجليزية إلا إذا طلبت تلك اللغة.

أمثلة

الافتراضي (الإنجليزية فقط) — متطابقان:

query=Alibaba
query=Alibaba&language=en

نطاق صيني:

query=Alibaba&language=zh

تغطية الإنجليزية + الصينية — طلبان ثم دمج:

query=Alibaba&language=en
query=Alibaba&language=zh

نصيحة: استخدم رموز ISO 639-1 (en، de، fr، zh، إلخ). تمتد مجموعة مصادر finlight الأساسية عبر لغات متعددة — الإنجليزية مجرد مرشّح افتراضي، وليست حد النطاق.

تصفية الاستعلامات

يتيح معامل query منطقاً مرناً قائماً على الكلمات المفتاحية ودقةً على مستوى الحقول. يمكنك الآن استهداف حقول محددة مثل ticker وexchange وisin وsource وopenfigi وغيرها.

الاستخدام الأساسي للكلمات المفتاحية

كلمة مفتاحية واحدة:

query=Nvidia stock

عبارة دقيقة: للبحث عن تطابق تام، ضع العبارة بين علامتي اقتباس مزدوجتين.

query="Elon Musk"

التضمين / الاستبعاد باستخدام المعاملات

فرض التضمين (+) والاستبعاد (-):

استخدم + لـ الإلزام/التضمين، و- لـ استبعاد مصطلح أو قيمة خاصة بحقل.

query=stock +market -google

سيُرجع هذا مقالات تتضمن «stock» و«market» لكنه يستبعد تلك التي تذكر «google».

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

ملاحظة: هذه ميزة جديدة قوية تتيح لك تصفية النتائج حسب حقول محددة مباشرةً داخل معامل query.

يمكنك الآن الاستعلام عن حقول محددة مباشرةً باستخدام صياغة field:value في معامل query. يتيح ذلك استعلامات أكثر دقة وتعقيداً، مما يمكّنك من تصفية النتائج حسب سمات معينة مثل رموز الأسهم والبورصات وأرقام ISIN والمصادر وغيرها.

✨ جديد: استخدم العلامة النائبة * مع حقول source وticker وexchange للمطابقة مع أي قيمة (مثل source:*، ticker:*، exchange:*).

الحقول المدعومة

  • ticker (يدعم العلامة النائبة *)

  • isin

  • title

  • summary

  • content

  • openfigi

  • exchange (يدعم العلامة النائبة *)

    • جميع البورصات تتبع معيار MIC (رمز معرّف السوق). الرموز المدعومة هي: ASEX, BVCA, BVMF, DSMD, HSTC, XSTC, MISX, NEOE, PFTS, ROCO, XADS, XAMM, XAMS, XASX, XBAH, XBEL, XBEY, XBKK, XBOG, XBOM, XBOT, XBRA, XBRU, XBSE, XBUD, XBUE, XBUL, XCAS, XCNQ, XCOL, XCSE, XCYS, XDAR, XDFM, XDHA, XDUS, XETR, XFKA, XFRA, XGHA, XHAM, XHEL, XHKG, XICE, XIDX, XIST, XJAM, XJSE, XKAR, XKAZ, XKLS, XKOR, XKUW, XLIM, XLIS, XLIT, XLJS, XLUS, XLUX, XMAL, XMAU, XMEX, XMIL, XMSW, XMUN, XNAI, XNAM, XNAS, XNGM, XNGO, XNSA, XNSE, XNYS, XASE, XOSL, XPAR, XPHS, XPRA, XRIS, XSAP, XSAU, XSES, XSCA, XSGO, XSHE, XSHG, XKRX, XSTU, XSWX, XTAE, XTAI, XTAL, XTSE, XTSX, XTUN, XUBS, XUGA, XWAR, XWBO, XZAG, XZIM, XSTO, OTCM, BMEX, XDUB, XJPX, BCXE, XPAE, XLON, XMUS, XNZE, XCAI, XBRV

  • country

    • التصفية حسب دولة الشركة باستخدام رموز ISO 3166-1 alpha-2 (مثل US، GB، DE، JP، CN، FR، CA، AU، IN، BR وغيرها)

  • category

    • التصفية حسب فئة المقال. القيم الممكنة: markets, economy, business, politics, geopolitics, regulation, technology, energy, commodities, crypto, health, climate, security

  • source (يدعم العلامة النائبة *)

دعم العلامات النائبة

تتيح لك العلامة النائبة * تضمين كل المصادر أو رموز الأسهم أو البورصات صراحةً في استعلامك. هذا مفيد بشكل خاص لضمان تغطية واسعة أو عند الدمج مع مرشّحات أخرى.

أمثلة:

query=source:*

يُرجع مقالات من جميع المصادر المتاحة.

query=ticker:* country:US

يُرجع مقالات لجميع رموز الأسهم لشركات من الولايات المتحدة.

query=exchange:* -crypto

يُرجع مقالات من جميع البورصات، باستثناء محتوى العملات المشفرة.

أمثلة على تصفية الحقول

اطّلع على كيفية عمل ذلك في أداة اختبار API وأنشئ استعلاماتك المعقدة الخاصة بسهولة.

التصفية حسب مصدر دقيق:

query=source:www.some-source.de

استبعاد مصدر:

query=-source:www.some-source.de

اشتراط رمز سهم محدد واستبعاد بعض المصادر:

query=ticker:AAPL -source:www.some-source.de

العثور على نتائج يذكر فيها المحتوى «earnings» والبورصة هي NASDAQ:

query=content:earnings exchange:nasdaq

التصفية حسب شركات من دولة محددة:

query=country:US

العثور على أخبار عن شركات ألمانية مع استبعاد Schulden:

query=country:DE -Schulden

الدمج بين تصفية الدولة ورمز السهم:

query=country:US ticker:NVD

الدمج بين تصفية الحقول والبحث العادي:

query="quarterly report" source:www.some-source.com -crypto

المعاملات المنطقية

ملاحظة: تُدمج الكلمات افتراضياً بـ AND، لذا لا حاجة لاستخدام AND صراحةً ما لم تكن تدمجها مع OR أو NOT.

منطق AND / OR / NOT مدعوم بالكامل:

query=stock AND google
query=amazon OR google
query=market AND NOT bitcoin

استخدم الأقواس للتجميع: ادمج التعبيرات المنطقية للتصفية المتقدمة.

query=("Elon Musk") AND (twitter OR tesla)

ادمج مع العلامات النائبة لاستعلامات قوية:

query=ticker:* AND (country:US OR country:GB) -crypto
query=source:* exchange:XNAS

💡 نصائح للمستخدمين المتقدمين

  • تدعم مرشّحات الحقول + و- للقيم المطلوبة والمستبعدة.
  • يمكن استخدام العلامة النائبة * مع حقول source وticker وexchange للمطابقة مع أي قيمة.
  • يمكنك دمج حقول وكلمات مفتاحية متعددة لاستعلامات شديدة الاستهداف.
  • المعاملات المنطقية مثل AND وOR وNOT غير حساسة لحالة الأحرف.
  • تساعد الأقواس () في التحكم بالأولوية في الاستعلامات المعقدة.
  • ضع العبارات متعددة الكلمات بين علامتي اقتباس مزدوجتين " لتجنب المطابقات الجزئية.

الخلاصة - دمج كل ذلك معاً

مثال: هل تريد أخبار Tesla (ticker:TSLA) غير المتعلقة بالعملات المشفرة من مصادر موثوقة؟

query=+ticker:TSLA -crypto AND (+source:www.bloomberg.com OR +source:www.reuters.com)

مثال: هل تريد أخبار Tesla (ticker:TSLA) أو Apple (ticker:AAPL) من Bloomberg؟

query=source:www.bloomberg.com AND ticker:TSLA OR source:www.bloomberg.com AND ticker:APPL

مثال: هل تريد أخباراً عن شركات أمريكية مدرجة في NASDAQ لكن دون محتوى عملات مشفرة؟

query=country:US exchange:XNAS -crypto

مثال: هل تريد أخباراً عن شركات تقنية أوروبية (ألمانيا أو فرنسا أو المملكة المتحدة) مع ذكر الأرباح؟

query=earnings AND (country:DE OR country:FR OR country:GB)

مثال: هل تريد أخباراً عن جميع رموز الأسهم من جميع المصادر، باستثناء العملات المشفرة؟

query=ticker:* source:* -crypto

اطّلع على كيفية عمل ذلك في أداة اختبار API وأنشئ استعلاماتك المعقدة الخاصة بسهولة.

حقول استعلام Raw WebSocket

يدعم Raw WebSocket مجموعة فرعية من مرشّحات مستوى الحقول، مصمّمة لنموذج بياناته المبسّط. على عكس WebSocket المُثرى وواجهة REST API، لا يدعم Raw WebSocket مرشّحات الحقول المتعلقة برموز الأسهم أو البورصات أو الشركات.

الحقول المدعومة

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

أمثلة

التصفية حسب محتوى العنوان:

query=title:Nvidia

الدمج بين مرشّحي العنوان والملخص:

query=summary:earnings +title:Tesla

التصفية حسب المصدر واستبعاد كلمة مفتاحية:

query=source:www.reuters.com -crypto

الدمج بين عدة مرشّحات حقول باستخدام المعاملات المنطقية:

query=title:Apple AND summary:revenue

ملاحظة: جميع معاملات الاستعلام القياسية (+، -، AND، OR، NOT، الأقواس، علامات الاقتباس المزدوجة) تعمل مع مرشّحات حقول Raw WebSocket.

هل تحتاج إلى مساعدة؟

إذا واجهت عائقاً أو كانت لديك أسئلة أو رأيت ما يمكن تحسينه، فلا تتردد في التواصل. يسعدنا تواصلك ونحن هنا لدعم نجاحك مع واجهة finlight.me API.