आपको उन फ़ाइलों की सूची बनाने के लिए एक एपीआई की आवश्यकता है जिन्हें आप पढ़ने के लिए अधिकृत हैं, यह सत्यापित करने के लिए कि एक लक्षित फ़ाइल मौजूद है, और फिर बिना नाम या पथ का अनुमान लगाए इसे खींचने के लिए। इस लेख के अंत तक आप एक वास्तविक "फाइलों की सूची" एंडपॉइंट को कॉल करेंगे, इसके उत्तर को पार्स करेंगे, और उन फ़ाइलों में से एक को प्राप्त करेंगे - साफ-सुथरा, कैशिंग सेमांटिक्स के साथ जिसे आप इस सप्ताह उत्पादन में जोड़ सकते हैं।
यह एपीआई क्या करता है
Zyla API Hub पर Fonbet Odds API फ़ाइल-उन्मुख एक्सेस को बुकमेकर ऑड्स स्नैपशॉट्स के लिए उजागर करता है। यह प्रदान करता है:
- एक फ़ाइल सूचीकरण एंडपॉइंट जो आपके सब्सक्रिप्शन द्वारा पढ़ी जा सकने वाली ऑड्स फ़ाइलों के सटीक सेट को नाम के अनुसार क्रमबद्ध करके लौटाता है। आप इसे पहले कॉल करते हैं और केवल इसके द्वारा प्रदान किए गए नामों के साथ काम करते हैं।
- उन फ़ाइलों में से एक को प्राप्त करने के लिए एक एंडपॉइंट, जो मेटाडेटा और बुकमेकर का मूल JSON बिना बदले एक लिफाफे में लौटाता है।
यह पूरी तरह से एक फ़ाइल प्रबंधन कार्यप्रवाह है: उपलब्ध फ़ाइलों का पता लगाना, नाम द्वारा एक का चयन करना, और इसे डाउनलोड करना। यह इनजेशन नौकरियों को सुव्यवस्थित करने, खींचने से पहले एक्सेस को सत्यापित करने, और आपकी ऑड्स पाइपलाइन को मजबूत रखने के लिए उपयुक्त है।
Zyla API Hub पर शुरू करना
Fonbet Odds API के लिए एपीआई पृष्ठ खोलें, यदि उपलब्ध हो तो सब्सक्राइब या फ्री ट्रायल शुरू करने पर क्लिक करें, और अपना एपीआई कुंजी प्राप्त करें। प्रमाणीकरण एकल हेडर है जिसे आप अनुरोधों में जोड़ते हैं। Zyla API Hub एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। आपके खाते पर पहला एपीआई 7-दिन का परीक्षण या 50 अनुरोध प्रदान कर सकता है; हमेशा वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
आप Zyla API Hub पर हजारों उत्पादन-तैयार एपीआई ब्राउज़ कर सकते हैं, सभी एक खाते और एक एपीआई कुंजी के तहत। जब आप इस विशिष्ट एपीआई का परीक्षण करने के लिए तैयार हों, तो नीचे दिए गए सूचीकरण लिंक का उपयोग करें।
आप जिन एंडपॉइंट्स का उपयोग करेंगे
बेस: सभी कॉल नीचे दिखाए गए Zyla के हब यूआरएल पर जाती हैं। जब तक वे प्रलेखित नहीं हैं, क्वेरी पैरामीटर न जोड़ें। प्रमाणीकरण के लिए Authorization: Bearer YOUR_API_KEY के माध्यम से आवश्यक है।
1) फाइलों की सूची
- विधि: GET
- यूआरएल: https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
- विवरण: उन ऑड्स फ़ाइलों की सूची बनाता है जिन्हें आपका सब्सक्रिप्शन पढ़ सकता है, नाम के अनुसार क्रमबद्ध। कंपनी, गिनती, और फ़ाइलें (फ़ाइल नामों का एक सरणी) लौटाता है। इसे पहले कॉल करें और केवल उन नामों का अनुरोध करें जो यह लौटाता है।
- पैरामीटर: कोई प्रलेखित नहीं।
cURL (कॉपी/पेस्ट करने योग्य):
curl -s -X GET "https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files"
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक उदाहरण प्रतिक्रिया:
{
"company": "fonbet",
"count": 1,
"files": [
"site_livepre_fonbet.json"
]
}
आप वास्तव में क्या उपयोग करेंगे:
- कंपनी: डेटा प्रदाता की पहचान करने वाला स्ट्रिंग (यहां, "fonbet").
- गिनती: फ़ाइलों की संख्या जिन तक आपकी वर्तमान सब्सक्रिप्शन पहुंच सकती है।
- फ़ाइलें: फ़ाइल नामों की सरणी। ये केवल मान्य इनपुट हैं जिन्हें आप प्राप्त करने का प्रयास करना चाहिए।
2) डेटा प्राप्त करें
- विधि: GET
- यूआरएल: https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
- विवरण: एक लिफाफे के अंदर एक ऑड्स फ़ाइल लौटाता है: {"company", "file", "updated_at", "data"}। डेटा फ़ील्ड में बुकमेकर का अपना JSON होता है, बिना बदले। updated_at अंतिम रिफ्रेश समय (UTC) है। वही समय Last-Modified हेडर के माध्यम से प्रदान किया गया है; जब कुछ भी नहीं बदला हो तो 304 प्राप्त करने के लिए इसे If-Modified-Since के माध्यम से वापस भेजें।
- पैरामीटर: कोई प्रलेखित नहीं।
cURL:
उदाहरण प्रतिक्रिया (कच्चे ऑड्स JSON के साथ लिफाफा):
उत्पादन उपयोग के लिए मुख्य बिंदु:
- updated_at UTC है। इसे ताजगी जांच के लिए अपने मानक घड़ी के रूप में मानें।
- HTTP कैशिंग हेडर का उपयोग करें: प्रत्येक सफल GET पर, Last-Modified पढ़ें; इसे बाद के अनुरोधों पर If-Modified-Since के रूप में वापस भेजें ताकि जब डेटा नहीं बदला हो तो अनावश्यक डाउनलोड से बचा जा सके।
- डेटा के तहत बुकमेकर JSON बिना बदले है; आकार बड़ा और नेस्टेड हो सकता है, इसलिए केवल वही पार्स करें जिसकी आपको आवश्यकता है।
एंड-टू-एंड उदाहरण: एक फ़ाइल का पता लगाना और प्राप्त करना
कार्यप्रवाह रूपरेखा:
- अनुमति प्राप्त फ़ाइल नामों का पता लगाने के लिए List Files को कॉल करें।
- files[] से आपको आवश्यक फ़ाइल चुनें।
- कच्चे ऑड्स JSON के साथ लिफाफा प्राप्त करने के लिए Get Data को कॉल करें।
- भविष्य के शर्तीय अनुरोधों के लिए updated_at और Last-Modified हेडर को स्टोर करें।
पायथन उदाहरण
यह स्क्रिप्ट फ़ाइलों की सूची बनाती है, पहले फ़ाइल नाम का चयन करती है, इसे प्राप्त करती है, और बुनियादी मेटाडेटा प्रिंट करती है। यह बाद में शर्तीय अनुरोधों को जोड़ने के लिए Last-Modified पढ़ने का प्रदर्शन भी करती है।
import os
import sys
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY")
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
LIST_URL = "https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files"
GET_URL = "https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data"
def list_files():
r = requests.get(LIST_URL, headers=HEADERS, timeout=30)
r.raise_for_status()
return r.json()
def get_data(if_modified_since=None):
headers = HEADERS.copy()
if if_modified_since:
headers["If-Modified-Since"] = if_modified_since
r = requests.get(GET_URL, headers=headers, timeout=60)
if r.status_code == 304:
return {"status": 304, "last_modified": if_modified_since, "body": None}
r.raise_for_status()
return {
"status": r.status_code,
"last_modified": r.headers.get("Last-Modified"),
"body": r.json()
}
def main():
listing = list_files()
print(f"Company: {listing.get('company')}")
print(f"File count: {listing.get('count')}")
files = listing.get("files", [])
if not files:
print("No files available for this subscription.")
sys.exit(0)
target = files[0]
print(f"Fetching: {target} via Get Data endpoint")
# First fetch
result = get_data()
print(f"HTTP: {result['status']}, Last-Modified: {result['last_modified']}")
if result["body"]:
env = result["body"]
print(f"Envelope: company={env.get('company')}, file={env.get('file')}, updated_at={env.get('updated_at')}")
# The raw bookmaker JSON is at env['data']; avoid printing huge payloads in production.
# Example conditional request using Last-Modified
if result["last_modified"]:
result2 = get_data(if_modified_since=result["last_modified"])
print(f"Conditional fetch -> HTTP: {result2['status']} (304 means unchanged)")
if __name__ == "__main__":
main()
नोट्स:
- List Files एंडपॉइंट कोई अनुरोध पैरामीटर प्रलेखित नहीं करता है - कोई भी न जोड़ें।
- Get Data एंडपॉइंट भी कोई पैरामीटर प्रलेखित नहीं करता है; यह अपने मानक लिफाफे के अंदर अनुमति प्राप्त फ़ाइल लौटाएगा।
- अपने वातावरण के लिए समझ में आने वाले टाइमआउट का उपयोग करें और इंक्रीमेंटल रन के लिए Last-Modified को लॉग करें।
व्यावहारिक एकीकरण विवरण जो समय बचाते हैं
- प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY भेजें।
- फ़ाइल नाम: List Files से files[] को सत्यता के स्रोत के रूप में मानें। एपीआई द्वारा लौटाए गए नामों के बाहर नाम हार्डकोड न करें।
- क्रम: सूची नाम के अनुसार क्रमबद्ध है। यदि आप केवल एक की अपेक्षा करते हैं, तो गिनती == 1 को अस्वीकार करें ताकि जब आपकी सब्सक्रिप्शन बदलती है तो जल्दी विफल हो जाएं।
- टाइमस्टैम्प: updated_at एक ISO 8601 UTC स्ट्रिंग है (जैसे, 2026-09-27T18:24:34Z)। इसे ऑडिट के लिए अपने इनजेशन बैच के साथ स्टोर करें।
- कैशिंग: बैंडविड्थ और प्रोसेसिंग को कम करने के लिए Last-Modified/If-Modified-Since का सम्मान करें। 304 का अर्थ है कि आप अपने अंतिम स्नैपशॉट का पुन: उपयोग कर सकते हैं।
- पैजिनेशन: List Files पर प्रलेखित नहीं; कोड करें जैसे कि सूची एक पृष्ठ में फिट होती है। यदि आपकी सब्सक्रिप्शन बढ़ती है, तो एपीआई पृष्ठ पर दस्तावेज़ों की फिर से जांच करें।
- डेटा मात्रा: डेटा बुकमेकर का मूल JSON है। यह बड़ा हो सकता है; इसे डिस्क पर स्ट्रीम करें या चयनात्मक रूप से पार्स करें।
- त्रुटि हैंडलिंग: प्रमाणीकरण/सब्सक्रिप्शन मुद्दों के लिए 401/403 और कैश हिट के लिए 304 को संभालें। गैर-200 प्रतिक्रियाओं को सचेत रूप से पुनः प्रयास करना चाहिए।
- पर्यावरण: एपीआई कुंजी को स्रोत नियंत्रण से बाहर रखें। टाइमआउट और बैकऑफ को पैरामीटर करें।
- डिप्लॉयमेंट: फ़ाइलों की पहुंच में परिवर्तन का पता लगाने के लिए स्टार्टअप पर या शेड्यूल पर List Files चलाएं।
वास्तविक दुनिया के उपयोग के मामले
- ETL बूटस्ट्रैप: एक नौकरी की शुरुआत में एक्सेस को मान्य करने के लिए List Files का उपयोग करें, एक लाइव फ़ाइल प्राप्त करें, updated_at और Last-Modified को अपनी नौकरी के मेटाडेटा में जोड़ें, और पार्स की गई ऑड्स को अपने स्टोर में डालें।
- इंक्रीमेंटल सिंक: एक टाइमर पर, If-Modified-Since के साथ Get Data को कॉल करें। यदि 304, छोड़ें; यदि 200, updated_at के आधार पर न्यूनतम डिफ्स को प्रोसेस करें।
- एक्सेस मॉनिटरिंग: जब List Files से गिनती या फ़ाइल नाम बदलते हैं (जैसे, आपकी योजना के लिए एक फ़ाइल जोड़ी गई/हटाई गई) तो अलर्ट करें।
- कैश वार्मिंग: उपयोगकर्ता ट्रैफ़िक से पहले लक्ष्यों को चुनने के लिए List Files का उपयोग करके डिप्लॉय के दौरान प्री-फेच करें, फिर Get Data का उपयोग करके कैश को गर्म करें।
AI एजेंटों द्वारा MCP के माध्यम से कॉल करना
Zyla पर हर एपीआई को MCP एंडपॉइंट के माध्यम से AI एजेंटों द्वारा कॉल किया जा सकता है। अपने MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) को MCP गेटवे पर इंगित करें और अपनी Zyla API कुंजी पास करें। आपका एजेंट फिर ऊपर दिखाए गए समान हब यूआरएल को उसी प्रमाणीकरण हेडर का उपयोग करके सक्रिय कर सकता है।
दस्तावेज़ और एंडपॉइंट: MCP
एजेंट के अंदर सामान्य प्रवाह:
- टूल स्टेप 1: अपने प्रमाणीकरण हेडर के साथ List Files यूआरएल को GET करें; files[]. को पार्स करें।
- टूल स्टेप 2: Get Data यूआरएल को GET करें; यदि Last-Modified मौजूद है, तो कैश करें और If-Modified-Since के माध्यम से पुन: उपयोग करें।
यदि आपकी टीम Zyla के माध्यम से कई एपीआई का प्रबंधन करती है, तो MCP एक कुंजी और एक एकीकरण परत के तहत एक्सेस को केंद्रीकृत करता है। आप Zyla API Hub पर अधिक विकल्पों का अन्वेषण कर सकते हैं।
कॉपी-तैयार संदर्भ
फाइलों की सूची
GET https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
हेडर:
- Authorization: Bearer YOUR_API_KEY
कंपनी, गिनती, फ़ाइलें[] लौटाता है।
डेटा प्राप्त करें
GET https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
हेडर:
- Authorization: Bearer YOUR_API_KEY
- If-Modified-Since: {पिछले 200 से Last-Modified} (वैकल्पिक, कैशिंग के लिए)
कंपनी, फ़ाइल, updated_at (UTC), और डेटा (कच्चा बुकमेकर JSON) लौटाता है। Last-Modified हेडर भेजता है; यदि आप If-Modified-Since प्रदान करते हैं तो 304 जब कुछ भी नहीं बदला।
अक्सर पूछे जाने वाले प्रश्न
प्रश्न: मुझे कैसे पता चलेगा कि मैं किन फ़ाइल नामों को प्राप्त करने के लिए अधिकृत हूं?
उत्तर: List Files एंडपॉइंट को कॉल करें। केवल फ़ाइलों की सरणी में पाए गए नामों का अनुरोध करें।
प्रश्न: updated_at कौन सा टाइमज़ोन है?
उत्तर: UTC (जैसे, 2026-09-27T18:24:34Z)। इसका उपयोग ऑडिट और ताजगी जांच के लिए करें।
प्रश्न: क्या मैं फ़ाइल को फिर से डाउनलोड करने से बच सकता हूं यदि कुछ भी नहीं बदला?
उत्तर: हां। 200 प्रतिक्रिया से Last-Modified हेडर पढ़ें और इसे If-Modified-Since के माध्यम से वापस भेजें। जब फ़ाइल अपरिवर्तित होती है तो आपको HTTP 304 प्राप्त होगा।
प्रश्न: क्या फ़ाइल सूची या डेटा को फ़िल्टर करने के लिए कोई क्वेरी पैरामीटर हैं?
उत्तर: इन एंडपॉइंट्स के लिए कोई पैरामीटर प्रलेखित नहीं हैं। सूची को पूर्ण और डेटा को पूर्ण, अपरिवर्तित JSON के रूप में मानें।
प्रश्न: बिलिंग कैसे संभाली जाती है?
उत्तर: Zyla सब्सक्रिप्शन + कोटा (पे-पर-कॉल नहीं) का उपयोग करता है। पहला एपीआई 7-दिन का परीक्षण या 50 अनुरोध प्रदान कर सकता है। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
क्या आप अपने "पहले सूची फिर प्राप्त करें" फ़ाइल कार्यप्रवाह को लागू करने के लिए तैयार हैं? आधिकारिक सूचीकरण के साथ शुरू करें और अपनी कुंजी प्राप्त करें: Fonbet Odds API पर 7-दिन का परीक्षण शुरू करें. एक खाता और एक एपीआई कुंजी Zyla पर 10,000 से अधिक सार्वजनिक एपीआई तक पहुंच को अनलॉक करती है।