Raw - लेखों की सदस्यता लें
Raw WebSocket एनरिच्ड WebSocket का एक हल्का, सुव्यवस्थित विकल्प प्रदान करता है। यह टिकर मिलान, AI संवर्धन, या कंपनी इकाई समाधान के बिना लेख का मुख्य डेटा रीयल-टाइम में डिलीवर करता है। यह इसे ऐसे उपयोग-मामलों के लिए आदर्श बनाता है जहाँ आपको उन्नत प्रसंस्करण के ओवरहेड के बिना तेज़, बुनियादी लेख डेटा चाहिए।
एनरिच्ड WebSocket से मुख्य अंतर:
- एंडपॉइंट:
wss://wss.finlight.me/raw(wss://wss.finlight.meके बजाय) - कोई आरंभिक डेटा नहीं: एनरिच्ड WebSocket के विपरीत, Raw WebSocket कनेक्ट या पुनः कनेक्ट होने पर मेल खाने वाला नवीनतम लेख नहीं भेजता। आप कनेक्ट होने के बाद केवल नए प्रकाशित लेख प्राप्त करेंगे।
- कोई AI संवर्धन नहीं: लेख सेंटिमेंट विश्लेषण, कंपनी मिलान, या टिकर समाधान के बिना डिलीवर किए जाते हैं।
- सरलीकृत पैरामीटर:
tickers,countries,includeEntities, याextendedपैरामीटर नहीं हैं।
लेख मॉडल
Raw WebSocket केवल मुख्य फ़ील्ड के साथ एक सरलीकृत लेख मॉडल लौटाता है। कोई कंपनी इकाइयाँ या 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 दिनांक के रूप में।
- Name
createdAt- Type
- Date
- Description
finlight सिस्टम में लेख की आंतरिक निर्माण तिथि ISO दिनांक के रूप में।
- 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", "DE"]। खाली हो सकती है।
- Name
categories- Type
- string[]
- Description
लेख श्रेणियों की ऐरे। संभावित मान:
markets|economy|business|politics|geopolitics|regulation|technology|energy|commodities|crypto|health|climate|security। खाली हो सकती है।
लेख प्राप्त करें
कनेक्ट होने के बाद, आप केवल अपने मानदंडों से मेल खाने वाले नए प्रकाशित लेख प्राप्त करेंगे। कनेक्ट होने पर कोई आरंभिक/ऐतिहासिक लेख नहीं भेजा जाता।
सदस्यता लेते समय, आप प्राप्त होने वाले लेखों को फ़िल्टर करने के लिए निम्नलिखित पैरामीटर निर्दिष्ट कर सकते हैं:
- Name
query- Type
- string
- Description
प्रासंगिक लेख खोजने के लिए खोज क्वेरी।
source,titleऔरsummaryफ़ील्ड के लिए फ़ील्ड-स्तरीय फ़िल्टरिंग का समर्थन करती है। उन्नत क्वेरीज़
- Name
sources- Type
- string[]
- Description
एकल या एकाधिक स्रोतों के अनुसार फ़िल्टर करें। जैसे
["www.reuters.com", "www.cnbc.com"]। मान्य मानों के लिए source एंडपॉइंट देखें।
- Name
excludeSources- Type
- string[]
- Description
एकल या एकाधिक स्रोतों को बाहर रखता है। जैसे
["www.reuters.com", "www.cnbc.com"]। मान्य मानों के लिए source एंडपॉइंट देखें।
- Name
language- Type
- string
- Description
भाषा के अनुसार फ़िल्टर करें (ISO 639-1)। डिफ़ॉल्ट
enहै, जो केवल अंग्रेज़ी लौटाता है और अन्य भाषाओं को बाहर रखता है — भाषा और कवरेज देखें।
- Name
includeUpdates- Type
- boolean
- Description
सक्षम होने पर, अपडेट किए गए लेख
isUpdate=trueऔर एकrevisedDateटाइमस्टैम्प के साथ पुनः डिलीवर किए जाते हैं।
Request
import { FinlightApi } from 'finlight-client'
const client = new FinlightApi(
{
apiKey: 'YOUR_API_KEY', // Replace with your API key
},
{
takeover: true, // WebSocket options
},
)
client.rawWebsocket.connect(
{
query: 'Nvidia',
language: 'en',
sources: ['www.reuters.com', 'www.cnbc.com'],
},
(article) => {
console.log('New article received:', article)
},
)
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 फ़ील्ड-स्तरीय फ़िल्टरिंग
Raw WebSocket निम्नलिखित फ़ील्ड के लिए query पैरामीटर के भीतर फ़ील्ड-स्तरीय फ़िल्टरिंग का समर्थन करता है:
source- लेख स्रोत के अनुसार फ़िल्टर करेंtitle- लेख शीर्षक सामग्री के अनुसार फ़िल्टर करेंsummary- लेख सारांश सामग्री के अनुसार फ़िल्टर करें
उदाहरण:
query=title:Nvidia
query=summary:earnings +title:Tesla
query=source:www.reuters.com -crypto
क्वेरी सिंटैक्स के बारे में अधिक जानकारी के लिए उन्नत क्वेरी निर्माण गाइड देखें।
कनेक्शन व्यवहार
- प्रमाणीकरण: एनरिच्ड WebSocket के समान
x-api-keyहेडर का उपयोग करता है। विवरण के लिए WebSocket मूल बातें देखें। - Ping/Pong: वही कीप-अलाइव तंत्र लागू होता है। कनेक्शन बनाए रखने के लिए समय-समय पर
pingसंदेश भेजें। - कनेक्शन अवधि: वही 2-घंटे की कनेक्शन सीमा लागू होती है। तदनुसार पुनः कनेक्ट लॉजिक लागू करें।
- कोई आरंभिक डेटा नहीं: एनरिच्ड WebSocket के विपरीत, कनेक्ट या पुनः कनेक्ट होने पर मेल खाने वाला नवीनतम लेख नहीं लौटाया जाता। कनेक्शन के बाद केवल नए प्रकाशित लेख डिलीवर किए जाते हैं।