تتبّع تحديثات الأخبار العاجلة باستخدام revisedDate

تتبّع تحديثات الأخبار العاجلة باستخدام revisedDate

الأخبار ليست ثابتة. تنفجر قصة ما، ثم يصحّح الناشر رقمًا، أو يضيف اقتباسًا، أو يحدّث العنوان مع تطوّر الموقف. إذا كنت تتتبّع وقت النشر فقط، فستفوتك تلك المراجعات. يوفّر finlight حقل revisedDate حتى تتمكن من التقاط القصص التي تغيّرت بعد نشرها لأول مرة.

الترتيب حسب أحدث مراجعة

لإبراز المقالات المُحدَّثة مؤخرًا، رتّب حسب revisedDate على POST /v2/articles:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tickers": ["AAPL"],
    "orderBy": "revisedDate",
    "order": "DESC",
    "pageSize": 20
  }'

عندما ترتّب حسب revisedDate، يتضمّن كل مقال كلًّا من publishDate الأصلي و revisedDate:

{
  "title": "Apple expands services guidance after earnings call",
  "publishDate": "2026-06-18T09:00:00.000Z",
  "revisedDate": "2026-06-18T14:30:00.000Z"
}

اكتشاف ما تغيّر فعلًا

تخبرك مقارنة الطابعين الزمنيين أيُّ القصص جرى تحديثها، وكم من الوقت مرّ بعد النشر:

• إذا كان revisedDate لاحقًا لـ publishDate، فقد جرت مراجعة القصة.
• الفجوة بينهما تخبرك بمدى حداثة التحديث، وهو أمر مفيد للإشارة إلى القصص سريعة التطوّر.

حلقة استطلاع بسيطة ترتّب حسب revisedDate وتتذكّر آخر revisedDate رأته ستلتقط كل مراجعة منذ التشغيل السابق، دون إعادة معالجة المقالات التي لم تتغيّر.

معلومات مفيدة

• يعكس revisedDate آخر مرة راجع فيها مزوّد الأخبار المقال، وليس وقت استيعاب finlight له. استخدم createdAt إذا أردت وقت استيعاب finlight بدلًا من ذلك.
• يُرجَع هذا الحقل عندما ترتّب حسب revisedDate. اقرنه بأي عوامل تصفية تفضّلها (tickers، categories، query).
• توفّر حاليًا الـ SDK الرسمية finlight-client الترتيب حسب publishDate و createdAt. للترتيب حسب revisedDate اليوم، استدعِ نقطة نهاية REST مباشرة كما هو موضّح أعلاه.

إلى أين تذهب بعد ذلك

• التصفية المتقدمة: استعلامات دقيقة.
• التوثيق الكامل.

احصل على مفتاح API المجاني ←