आपको एक विश्वसनीय तरीके की आवश्यकता है ताकि आप हर खेल को सूचीबद्ध कर सकें जिसे आपका ऐप कवर कर सकता है, अभी—एक सप्ताह बाद नहीं। इस गाइड के अंत तक, आप एक ही अनुरोध के साथ सभी उपलब्ध खेलों को प्राप्त करने में सक्षम होंगे, उन्हें अपने नेविगेशन या सेटिंग्स में प्रदर्शित करेंगे, और अपने UI को टीम खोज और देश के झंडों के साथ बढ़ाएंगे, जो Zyla API Hub से एक ही सब्सक्रिप्शन और API कुंजी का उपयोग करते हैं।
यह API क्या करती है और कब इसका उपयोग करें
SofaScore - Live API Zyla API Hub पर खेलों के मेटाडेटा और खोज उपयोगिताएँ प्रदान करती है जिन्हें आप सीधे स्कोरबोर्ड, सट्टेबाजी साथी, समाचार ऐप, या डेटा पाइपलाइन में प्लग कर सकते हैं। इस लेख में, हम तीन एंडपॉइंट्स पर ध्यान केंद्रित करेंगे जिन्हें आप आज शिप कर सकते हैं:
- सभी खेल प्राप्त करें: id, नाम, और स्लग के साथ हर उपलब्ध खेल की सूची प्राप्त करें।
- सभी संस्थाओं की खोज करें: क्वेरी स्ट्रिंग द्वारा SofaScore संस्थाओं (जैसे, टीमें) को खोजें।
- देश का झंडा प्राप्त करें: अपने UI में प्रदर्शित करने के लिए देश के झंडे की छवि बाइट्स डाउनलोड करें।
सभी उदाहरण Zyla API Hub रूटिंग और एकल प्राधिकरण हेडर का उपयोग करते हैं। कोई कस्टम होस्ट नहीं, प्रति API कोई अलग खाते नहीं। यदि आप मार्केटप्लेस में नए हैं, तो आप zylalabs.com पर एक खाते और एक API कुंजी के साथ 10,000 से अधिक सार्वजनिक APIs का अन्वेषण कर सकते हैं।
Zyla API Hub पर शुरुआत करना
SofaScore - Live API लिस्टिंग खोलें, सब्सक्राइब करें, और अपनी कुंजी प्राप्त करें:
- API पृष्ठ पर जाएं: SofaScore - Live API पर 7-दिन का परीक्षण शुरू करें.
- अपनी API कुंजी प्राप्त करने के लिए सब्सक्राइब पर क्लिक करें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें)।
- नीचे दिए गए एंडपॉइंट्स के लिए हर अनुरोध में Authorization: Bearer YOUR_API_KEY का उपयोग करें।
Zyla पर बिलिंग सब्सक्रिप्शन + कोटा है (पे-पर-कॉल नहीं)। पहले API के लिए, 7-दिन का परीक्षण या 50 अनुरोध हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
एंडपॉइंट: सभी खेल प्राप्त करें
यह आपके खेल चयनकर्ता, फीचर टॉगल, या रूटिंग तालिकाओं के निर्माण के लिए प्रवेश बिंदु है। यह खेलों का एक एरे लौटाता है, प्रत्येक के साथ एक id, नाम, और स्लग। कोई अनुरोध पैरामीटर आवश्यक नहीं हैं।
- विधि: GET
- URL: https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports
- हेडर: Authorization: Bearer YOUR_API_KEY
- अनुरोध पैरामीटर्स: कोई नहीं
cURL उदाहरण
curl -s -X GET "https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports" \
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक उदाहरण प्रतिक्रिया
[
{
"id": 1,
"name": "Football",
"slug": "football"
},
{
"id": 5,
"name": "Tennis",
"slug": "tennis"
},
{
"id": 2,
"name": "Basketball",
"slug": "basketball"
},
{
"id": 64,
"name": "Baseball",
"slug": "baseball"
},
{
"id": 23,
"name": "Volleyball",
"slug": "volleyball"
},
{
"id": 63,
"name": "American football",
"slug": "american-football"
},
{
"id": 6,
"name": "Handball",
"slug": "handball"
},
{
"id": 20,
"name": "Table tennis",
"slug": "table-tennis"
},
{
"id": 4,
"name": "Ice hockey",
"slug": "ice-hockey"
},
{
"id": 22,
"name": "Darts",
"slug": "darts"
},
{
"id": 72,
"name": "E-sports",
"slug": "esports"
},
{
"id": 11,
"name": "Motorsport",
"slug": "motorsport"
},
{
"id": 65,
"name": "Cycling",
"slug": "cycling"
},
{
"id": 62,
"name": "Cricket",
"slug": "cricket"
},
{
"id": 76,
"name": "Mixed Martial Arts",
"slug": "mma"
},
{
"id": 12,
"name": "Rugby",
"slug": "rugby"
},
{
"id": 29,
"name": "Futsal",
"slug": "futsal"
},
{
"id": 31,
"name": "Badminton",
"slug": "badminton"
},
{
"id": 26,
"name": "Waterpolo",
"slug": "waterpolo"
},
{
"id": 19,
"name": "Snooker",
"slug": "snooker"
},
{
"id": 13,
"name": "Aussie rules",
"slug": "aussie-rules"
},
{
"id": 34,
"name": "Beach volley",
"slug": "beach-volley"
},
{
"id": 109,
"name": "Minifootball",
"slug": "minifootball"
},
{
"id": 7,
"name": "Floorball",
"slug": "floorball"
},
{
"id": 15,
"name": "Bandy",
"slug": "bandy"
},
{
"id": 110,
"name": "Padel",
"slug": "padel"
}
]
आप जिन फ़ील्ड्स का वास्तव में उपयोग करेंगे:
- id: खेल के लिए संख्यात्मक पहचानकर्ता। इसे संबंधी लुकअप के लिए स्टोर करें।
- name: मेनू और लेबल के लिए डिस्प्ले नाम।
- slug: स्थिर, URL-अनुकूल टोकन जो रूट और फीचर फ्लैग बनाने के लिए है।
Python उदाहरण: id द्वारा प्राप्त करें, क्रमबद्ध करें, और मैप करें
import requests
API_URL = "https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get(API_URL, headers=headers, timeout=10)
resp.raise_for_status()
sports = resp.json() # list of {id, name, slug}
# Sort alphabetically for a menu
sports_sorted = sorted(sports, key=lambda s: s["name"].lower())
# Build helper maps
by_id = {s["id"]: s for s in sports_sorted}
by_slug = {s["slug"]: s for s in sports_sorted}
# Example usage
print("Available sports:", ", ".join(s["name"] for s in sports_sorted))
print("Football id:", by_slug["football"]["id"])
एंडपॉइंट: सभी संस्थाओं की खोज करें
जब आपको एक खोज बार को शक्ति देने की आवश्यकता हो ताकि जल्दी से एक टीम, प्रतियोगिता, या संबंधित SofaScore संस्था पर कूद सकें, तो इसका उपयोग करें। यह क्वेरी स्ट्रिंग द्वारा संस्थाओं के बीच खोज करता है और मिलान करने वाले ऑब्जेक्ट लौटाता है।
- विधि: GET
- URL: https://zylalabs.com/api/12787/sofascore-live-api/25082/search-all-entities
- हेडर: Authorization: Bearer YOUR_API_KEY
- अनुरोध पैरामीटर्स:
- q (string, आवश्यक): खोज क्वेरी (जैसे, रियल मैड्रिड)
cURL उदाहरण
यह एंडपॉइंट ऐसे मैच लौटाता है जिनमें पहचानकर्ता, नाम, स्लग, और देश की जानकारी जैसे संस्था मेटाडेटा शामिल होते हैं। इसका उपयोग करें ताकि उपयोगकर्ता आपके "सभी खेल" सूची से एक खेल चुनने के बाद ऑटोकंप्लीट सुझावों को भर सके।
एंडपॉइंट: देश का झंडा प्राप्त करें
जब देश-स्तरीय संदर्भ (जैसे, एक टीम का देश) को प्रदर्शित करते हैं, तो आप देश कोड द्वारा एक झंडा छवि का अनुरोध कर सकते हैं और बाइट्स को सीधे अपने UI या कैश लेयर में उपयोग कर सकते हैं।
- विधि: GET
- URL: https://zylalabs.com/api/12787/sofascore-live-api/31197/get-country-flag
- हेडर: Authorization: Bearer YOUR_API_KEY
- अनुरोध पैरामीटर्स:
- country_code (string, आवश्यक): जैसे, EN
cURL उदाहरण
उदाहरण प्रतिक्रिया
iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAMAAAAL34HQAAAABGdBTUEAALGPC/xhBQAAAAFzUkdCAK7OHOkAAAAJcEhZcwAACxMAAAsTAQCanBgAAAELUExURUdwTN/f37QVJd7e3t3d3d/f39/f39/f397e3t7e3t3d3d3d3d3d3d/f397e3t/f39/f39zc3N7e3rQUJN/f37MUJLUTJd/f39/f3+Hh4d3d3bMUJLUVJbQUJLUVJbUUJLcQKOHh4d3d3bQVJLQUJN/f397e3rQVJbIWI7ITI7QUJLcYKM4RJP///97e3rQUJPv7++Li4v39/ebm5uDg4Orq6vDw8OTk5Pf397sTJPn5+bsUJPPz8/Ly8u7u7rcUJMcSJOzs7PHx8cQSJO/v77gUJLgTJOjo6MoSJMETJL8TJLUUJL4TJOvr680RJMsSJMsRJMQTJL0TJO3t7cwRJLYUJM0SJLwUJL4UJDN2488AAAAsdFJOUwB/38+AMBAg79+fcJBAv3CfYKC/YICfj79vr0AwcGCvIF+Pz8+vsKBQULAgUCRTtgAABilJREFUeNrtnGdX40YUhoWrhA1uGFj6tmQ34VrFKl6vzdqYDrtJNvX//5JMkSU3YWk0kiYn3A/CB3zMc+776s54NHMlKV6cfThp756+zeVUErlcq7XbPj48kjKLYqOel9WAkLf3GsXUkcqVA7mDIwiL/FE+qKSItrWndKZBIR6vrz+TuL6excKhbG6lwyR3/ND/eZiM7r6dz8bdaHL/tzPzJmUz4ZyVKtvePzMtu2fAeUCA0bNvde/N+UaCUBteorp2H0gEYpHo210/ZeVkXL7pMxkwjeexUGgDjywBMA/KufKZwmARMj0ZME++bg/mIwwWip7lgm1wBHtFocyxBsCGhVLmgim8zF+md585r15ULB8szyVhrn6WBhAPywfb4JWqJU8xYSEwan6lzMNV5iUAHywAelfKlTg34B5NlQb8sKZKvikxC5hfkyomLJQwM46QRTJPcDTgjeU6TGEawF+TXP8OwB8L4Ip8OIPBNoiAA0gGCy5NpkpBqPQ+JIXlCrnBQqVBclgsXITKMSBJLDCciFyEqhuGKg5WVC5C9RUgaSyArxG4XhEFIQ0sIDPX16GqaGhfccCiOoaoq2Vc2/WwVHGxwNBDjUMlJWRl4IRF60R+3biN5wxmeKr4WNDH…
प्रतिक्रिया शरीर का उपयोग छवि बाइट्स के रूप में करें। इसे अपने CDN के माध्यम से स्टोर और सर्व करें या इसे उस प्रारूप में परिवर्तित करें जिसकी आपकी फ्रंटेंड को आवश्यकता है।
वास्तविक-विश्व एकीकरण पैटर्न
- एक खेल चयनकर्ता बनाएं: ऐप बूट पर सभी खेलों को एक बार प्राप्त करें, नाम के अनुसार क्रमबद्ध करें, और ड्रॉपडाउन या सेगमेंटेड कंट्रोल के रूप में प्रदर्शित करें।
- प्रत्येक खेल के लिए फीचर गेट्स: खेल-विशिष्ट मॉड्यूल को टॉगल करने के लिए स्लग का उपयोग करें (जैसे, डेटा उपलब्ध होने पर "ice-hockey" सक्षम करें)।
- SEO-अनुकूल रूट: स्लग फ़ील्ड से /sports/football/ या /sports/mma/ जैसी URLs उत्पन्न करें।
- टीमों के लिए ऑटोकंप्लीट: जब उपयोगकर्ता एक खेल चुनता है, तो अपने खोज बॉक्स को "सभी संस्थाओं की खोज" पर हिट करने के लिए वायर करें जैसे "रियल मैड्रिड"।
- देश के बैज: टीमों, लीगों, या लीडरबोर्ड प्रविष्टियों के बगल में झंडे प्रदर्शित करने के लिए Get country flag का उपयोग करें।
समय बचाने वाले संचालन नोट्स
- कैशिंग: सभी खेलों की सूची अपेक्षाकृत स्थिर है। अपने बैकएंड में घंटों या एक दिन के लिए कैश करें। एक सरल invalidate-on-deploy रणनीति बनाए रखें।
- स्थानीयकरण: उदाहरण पेलोड अंग्रेजी नाम दिखाता है। यदि आपका UI कई भाषाओं का समर्थन करता है, तो स्लग से अलग डिस्प्ले स्ट्रिंग्स के लिए मैपिंग की योजना बनाएं।
- पहचानकर्ता: id और slug दोनों को बनाए रखें। बैकएंड जोड़ों के लिए id का उपयोग करें; URLs और फीचर रूटिंग के लिए slug का उपयोग करें।
- त्रुटि हैंडलिंग: डिफ़ॉल्ट रूप से गैर-200s को अस्थायी के रूप में मानें और पढ़ने के लिए बैकऑफ के साथ पुनः प्रयास लागू करें। अपने लॉग में अनुरोध id के साथ त्रुटियों को सतह पर लाएं।
- केवल हेडर: ये एंडपॉइंट Authorization: Bearer YOUR_API_KEY का उपयोग करते हैं। GETs पर अतिरिक्त बॉडी पैरामीटर्स न भेजें।
- कोटा: Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है। अपने वर्तमान सीमाओं और अपेक्षित उपयोग के लिए लिस्टिंग की जांच करें। कैशिंग द्वारा अनावश्यक पोलिंग से बचें।
न्यूनतम एंड-टू-एंड प्रवाह
- सर्वर स्टार्ट पर, सभी खेलों को प्राप्त करने का अनुरोध करें और एरे को कैश करें।
- नेविगेशन बनाने के लिए अपने फ्रंटएंड को कैश की गई सूची को उजागर करें, रूटिंग के लिए स्लग का उपयोग करें और आंतरिक संदर्भों के लिए id का उपयोग करें।
- उपयोगकर्ता खोज पर, Search all entities को कॉल करें जिसमें q उपयोगकर्ता के इनपुट पर सेट हो और सुझाव प्रदर्शित करें।
- जब आपको देश के दृश्य की आवश्यकता हो, तो उपयुक्त country_code के साथ Get country flag को कॉल करें और बाइट्स को स्टोर करें।
AI एजेंटों से MCP के माध्यम से कॉल करना
यदि आप MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) में प्रोटोटाइप कर रहे हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से समान APIs को कॉल कर सकते हैं। अपने उपकरण को इस पर इंगित करें:
जहां आपके क्लाइंट को इसकी आवश्यकता होती है, वहां अपनी Zyla API कुंजी प्रदान करें। आपका एजेंट फिर ऊपर दिखाए गए समान बियरर टोकन और URLs का उपयोग करके प्रलेखित SofaScore - Live API एंडपॉइंट्स को सक्रिय कर सकता है। यह स्कैफोल्डिंग स्क्रिप्ट्स के लिए उपयोगी है जो खेलों को प्राप्त करते हैं, स्लग की पुष्टि करते हैं, और कॉन्फ़िग फ़ाइलें उत्पन्न करते हैं।
परीक्षण चेकलिस्ट
- सफल GET to get-all-sports एक एरे लौटाता है; पुष्टि करें कि प्रत्येक आइटम में id, name, slug है।
- क्रमबद्ध आदेश: अपने स्वयं के क्रमबद्ध करने को संभालें; API आदेश की गारंटी नहीं देता।
- Slug सुरक्षा: स्लग URL-अनुकूल हैं; सुनिश्चित करें कि आपका राउटर हाइफन को संभालता है।
- खोज बार: कीस्ट्रोक्स को डिबाउंस करें और 200–300ms के बाद search-all-entities को q के साथ कॉल करें।
- झंडा छवियाँ: प्रतिक्रिया को छवि बाइट्स के रूप में मानें; अपने बैकएंड से लौटाते समय उचित Content-Type के माध्यम से सर्व करें।
Zyla आपको तेजी से शिप करने में कैसे मदद करता है
Zyla API Hub के साथ, आप हजारों APIs में एक ही खाता, कुंजी, और बिलिंग मॉडल का पुन: उपयोग करते हैं। इसका मतलब है कि आप बाद में अतिरिक्त खेल या गेमिंग एंडपॉइंट्स को बिना प्रमाणीकरण या खरीद के फिर से किए बिना प्लग कर सकते हैं। जब आप तैयार हों, तो zylalabs.com पर कैटलॉग का अन्वेषण करें और एकल एकीकरण से परे स्केल करें।
अक्सर पूछे जाने वाले प्रश्न
मैं प्रमाणीकरण कैसे करूं?
प्रत्येक अनुरोध में हेडर Authorization: Bearer YOUR_API_KEY जोड़ें।
क्या सभी खेलों को प्राप्त करने के लिए अनुरोध पैरामीटर हैं?
नहीं। एंडपॉइंट किसी भी अनुरोध पैरामीटर का दस्तावेजीकरण नहीं करता है; बस अपने प्राधिकरण हेडर के साथ GET भेजें।
मुझे कौन से प्रतिक्रिया फ़ील्ड्स स्टोर करने चाहिए?
कम से कम: id, name, slug। आंतरिक संदर्भों के लिए id का उपयोग करें और URLs और फीचर टॉगल के लिए slug का उपयोग करें।
क्या मैं खेलों की सूची को कैश कर सकता हूँ?
हाँ। कॉल को कम करने और स्टार्टअप समय में सुधार करने के लिए कैश करना एक अच्छा विचार है। एक समाप्ति चुनें जो आपकी रिलीज़ कैडेंस के अनुकूल हो।
मैं देश का झंडा कैसे प्रदर्शित करूं?
आवश्यक country_code पैरामीटर के साथ Get country flag को कॉल करें और UI में लौटाए गए छवि बाइट्स का उपयोग करें या उन्हें अपने CDN से सर्व करें।
क्या आप अपनी खेलों की सूची लागू करने और इस सप्ताह शिप करने के लिए तैयार हैं? SofaScore - Live API पृष्ठ पर सब्सक्राइब करें और अपनी कुंजी प्राप्त करें: SofaScore - Live API पर 7-दिन का परीक्षण शुरू करें.