रॉ Webhooks

रॉ Webhooks मानक (एनरिच्ड) webhooks का एक हल्का, तेज़-डिलीवरी विकल्प हैं। ये लेख के प्रकाशित होते ही उसका मुख्य डेटा डिलीवर करते हैं, AI संवर्धन पाइपलाइन को पूरी तरह छोड़ देते हैं।

एनरिच्ड Webhooks से मुख्य अंतर:

तेज़ डिलीवरी — लेख ग्रहण होते ही पुश कर दिए जाते हैं, सेंटिमेंट विश्लेषण, इकाई समाधान, या कंपनी मिलान की प्रतीक्षा किए बिना।
सरलीकृत फ़िल्टर — केवल query, sources, excludeSources, language और includeUpdates समर्थित हैं। tickers, countries, categories, includeContent, includeEntities और excludeEmptyContent उपलब्ध नहीं हैं।
कोई AI संवर्धन नहीं — पेलोड में sentiment, confidence, या companies डेटा शामिल नहीं होता।
query फ़ील्ड-स्तरीय फ़िल्टरिंग — query पैरामीटर केवल source, title और summary के लिए फ़ील्ड-स्तरीय सिंटैक्स का समर्थन करता है।
अपरिवर्तनीय प्रकार — डिलीवरी प्रकार (raw या enriched) निर्माण के समय सेट होता है और बाद में बदला नहीं जा सकता।

लेख मॉडल

रॉ Webhooks एक सरलीकृत लेख पेलोड डिलीवर करते हैं। कोई कंपनी इकाइयाँ, सेंटिमेंट स्कोर, या AI-जनित संवर्धन शामिल नहीं होते।

Name
link
Type
string
Description
पूर्ण लेख का URL।
Name
source
Type
string
Description
स्रोत वेबसाइट। जैसे www.reuters.com
Name
title
Type
string
Description
लेख का शीर्षक।
Name
summary
Type
string
Description
लेख का सारांश यदि मौजूद हो। नल हो सकता है।
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 बनाएँ

finlight डैशबोर्ड में webhook बनाते समय, सेटअप विज़ार्ड के पहले चरण में डिलीवरी प्रकार के रूप में Raw चुनें। तब मानदंड चरण केवल चार समर्थित फ़िल्टर पैरामीटर दिखाएगा।

रॉ Webhooks केवल आपके मानदंडों से मेल खाने वाले नए प्रकाशित लेख डिलीवर करते हैं। प्रत्येक डिलीवरी आपके एंडपॉइंट पर HTTP POST अनुरोध के रूप में भेजा गया एकल लेख पेलोड है।

Name
query
Type
string
Description
प्रासंगिक लेख खोजने के लिए खोज क्वेरी। source, title और summary फ़ील्ड के लिए फ़ील्ड-स्तरीय फ़िल्टरिंग का समर्थन करती है। नीचे query फ़ील्ड-स्तरीय फ़िल्टरिंग देखें।
Name
sources
Type
string[]
Description
डिलीवरी को विशिष्ट स्रोतों के लेखों तक सीमित करता है। जैसे ["www.reuters.com", "www.cnbc.com"]। मान्य मानों के लिए source एंडपॉइंट देखें।
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 फ़ील्ड-स्तरीय फ़िल्टरिंग

रॉ Webhooks का query पैरामीटर केवल इन फ़ील्ड तक सीमित फ़ील्ड-स्तरीय फ़िल्टरिंग का समर्थन करता है:

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 फ़िल्टरिंग विकल्पों के पूर्ण विवरण के लिए, फ़िल्टरिंग मानदंड गाइड देखें।