आपको इस सप्ताह एक खेल एकीकरण भेजने की आवश्यकता है: फ़िल्टर मेनू के लिए समर्थित खेलों की सूची, नाम द्वारा टीमों/लीगों की खोज करें, और क्लबों और राष्ट्रीय टीमों के बगल में देश के झंडे दिखाएं। इस लेख के अंत तक, आप जानेंगे कि Zyla API Hub पर SofaScore - लाइव API के साथ ऐसा कैसे करना है, जिसमें एक कार्यशील कर्ल कॉल, एक पायथन स्निपेट, और MCP के माध्यम से AI एजेंट से उसी API का उपयोग करने के लिए नोट्स शामिल हैं।
यह API क्या करती है और इसका उपयोग कब करें
SofaScore - लाइव API खेलों के मेटाडेटा का अन्वेषण करने और SofaScore के कैटलॉग में संस्थाओं की खोज करने के लिए एंडपॉइंट्स को उजागर करती है। इसके साथ, आप कर सकते हैं:
- उपलब्ध खेलों की सूची प्राप्त करें (जैसे, फ़ुटबॉल, टेनिस, बास्केटबॉल) फ़िल्टर, ऑनबोर्डिंग प्रवाह, या डेटासेट खोज को शक्ति देने के लिए।
- क्वेरी स्ट्रिंग द्वारा सभी संस्थाओं (टीम, आदि) की खोज करें ताकि उपयोगकर्ता इनपुट जैसे "रियल मैड्रिड" को IDs और छवि पथों के साथ एक मानक संस्थान में हल किया जा सके।
- जब आपको क्लबों, राष्ट्रीय टीमों, या खिलाड़ी प्रोफाइल के बगल में झंडे प्रदर्शित करने की आवश्यकता हो, तो कच्चे छवि बाइट्स के रूप में एक देश का झंडा प्राप्त करें।
विशिष्ट अनुप्रयोग: लाइव स्कोर डैशबोर्ड, सट्टेबाजी और फैंटेसी उपकरण, सामग्री और पूर्वावलोकन पृष्ठ, खेल द्वारा सामग्री को टैग करने के लिए प्रशासनिक बैक ऑफिस, और AI एजेंट जिन्हें खेलों की संस्थाओं के नामों को विश्वसनीय रूप से हल करने की आवश्यकता होती है।
Zyla API Hub पर शुरू करना
सभी कॉल एक API कुंजी और एक सदस्यता + कोटा मॉडल (प्रति कॉल भुगतान नहीं) के साथ Zyla API Hub के माध्यम से जाती हैं। पहली API में 7-दिन का परीक्षण या 50 अनुरोध शामिल हैं ताकि आप जल्दी से मान्य कर सकें। शुरू करने के लिए:
- SofaScore - लाइव API पृष्ठ खोलें और परीक्षण शुरू करें: SofaScore - लाइव API पर 7-दिन का परीक्षण शुरू करें.
- डैशबोर्ड से अपनी API कुंजी कॉपी करें।
- Authorization: Bearer YOUR_API_KEY हेडर के साथ प्रलेखित Zyla Hub URLs पर अनुरोध भेजें।
आप 10,000 से अधिक सार्वजनिक APIs की खोज कर सकते हैं और zylalabs.com पर एक ही खाते से उनका प्रबंधन कर सकते हैं। यदि आप बाद में अधिक खेल सुविधाएँ जोड़ने की योजना बना रहे हैं, तो एकीकृत कुंजी और सदस्यता इसे सरल बनाती है।
उपलब्ध एंडपॉइंट्स
नीचे इस API के लिए प्रलेखित एंडपॉइंट्स हैं। केवल सूचीबद्ध विधियाँ, URLs, और पैरामीटर उपलब्ध हैं; जैसा दिखाया गया है, ठीक उसी तरह लागू करें।
1) सभी खेल प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports
- पैरामीटर: कोई प्रलेखित नहीं
- उपयोग के मामले: ड्रॉपडाउन और फ़िल्टर को भरें, खेल स्लग को मान्य करें, अपने DB को खेल IDs/slugs के साथ पूर्व-बीजित करें।
कर्ल उदाहरण (कॉपी-पेस्ट के लिए तैयार):
curl -s -X GET "https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports"
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक नमूना JSON प्रतिक्रिया:
[
{
"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: UI में दिखाने के लिए डिस्प्ले नाम।
- slug: स्थिर पहचानकर्ता जो URLs और फ़िल्टर के लिए उपयुक्त है (जैसे, "football", "basketball").
2) सभी संस्थाओं की खोज करें
- विधि: GET
- URL: https://zylalabs.com/api/12787/sofascore-live-api/25082/search-all-entities
- पैरामीटर:
- q (string, आवश्यक): खोज क्वेरी, उदाहरण के लिए रियल मैड्रिड
- यह क्या करता है: क्वेरी स्ट्रिंग द्वारा सभी SofaScore संस्थाओं की खोज करता है। टाइपहेड के लिए उपयोगी, उपयोगकर्ता इनपुट को मानक IDs में हल करना, या टीमों के लिए सामग्री को ऑटो-लिंक करना।
पैरामीटर के साथ उदाहरण अनुरोध URL (प्राधिकरण हेडर आवश्यक):
https://zylalabs.com/api/12787/sofascore-live-api/25082/search-all-entities?q=real+madrid
3) देश का झंडा प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/12787/sofascore-live-api/31197/get-country-flag
- पैरामीटर:
- country_code (string, आवश्यक): एक अल्फा-2 शैली कोड, उदाहरण के लिए EN
- यह क्या करता है: देश के झंडे की छवि बाइट्स लौटाता है। झंडे के बैज के लिए आवश्यकतानुसार एम्बेड या बनाए रखें।
पैरामीटर के साथ उदाहरण अनुरोध URL (प्राधिकरण हेडर आवश्यक):
https://zylalabs.com/api/12787/sofascore-live-api/31197/get-country-flag?country_code=EN
पायथन उदाहरण: खेल कैटलॉग प्राप्त करें और उपयोग करें
यह पायथन स्निपेट Get all sports को कॉल करता है, उन कुछ फ़ील्ड्स को पार्स करता है जिनकी आपको सामान्यतः आवश्यकता होगी, और दिन के दौरान बार-बार पुनः प्राप्त करने से बचने के लिए सरल कैशिंग का प्रदर्शन करता है।
import os
import time
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# बहुत सरल कैश: हर 6 घंटे में रिफ्रेश करें
CACHE_FILE = "/tmp/sofascore_sports.json"
CACHE_TTL_SECONDS = 6 * 60 * 60
def should_refresh(path, ttl):
try:
mtime = os.path.getmtime(path)
except FileNotFoundError:
return True
return (time.time() - mtime) > ttl
def load_cached(path):
import json
with open(path, "r", encoding="utf-8") as f:
return json.load(f)
def save_cache(path, data):
import json
with open(path, "w", encoding="utf-8") as f:
json.dump(data, f)
def get_all_sports():
if not should_refresh(CACHE_FILE, CACHE_TTL_SECONDS):
return load_cached(CACHE_FILE)
resp = requests.get(URL, headers=HEADERS, timeout=15)
resp.raise_for_status()
data = resp.json() # Expecting a list of {id, name, slug}
save_cache(CACHE_FILE, data)
return data
if __name__ == "__main__":
sports = get_all_sports()
# स्लग -> id का लुकअप बनाएं
slug_to_id = {s["slug"]: s["id"] for s in sports}
# ड्रॉपडाउन के लिए नामों की एक क्रमबद्ध सूची रखें
sport_names = [s["name"] for s in sports]
print("Sport slugs -> ids:", slug_to_id)
print("Dropdown options:", sport_names)
व्यावहारिक कार्यान्वयन नोट्स
- प्रमाणीकरण: सभी एंडपॉइंट्स को हेडर Authorization: Bearer YOUR_API_KEY की आवश्यकता होती है।
- प्रतिक्रिया स्वरूप:
- Get all sports JSON सरणी आइटम के साथ id, name, slug लौटाता है।
- Search all entities क्वेरी से मेल खाने वाले संस्थाओं के मेटाडेटा के साथ JSON लौटाता है। इसका उपयोग उपयोगकर्ता इनपुट को IDs और छवि पथों से मैप करने के लिए करें।
- Get country flag छवि बाइट्स लौटाता है। इसे स्टोर करते समय या सर्व करते समय बाइनरी के रूप में मानें। जब आप फिर से सर्व करते हैं, तो उचित छवि सामग्री प्रकार सेट करें।
- कैशिंग:
- खेल कैटलॉग अक्सर बदलता नहीं है। प्रतिक्रिया को कैश करें (जैसे, 6–24 घंटे) कोटा बचाने और प्रारंभिक समय को कम करने के लिए।
- खोज परिणाम उपयोगकर्ता-प्रेरित होते हैं और भिन्न होते हैं; आप क्लब नामों जैसी सामान्य क्वेरीज़ को मेमोइज़ कर सकते हैं।
- देश के झंडे स्थिर होते हैं; एक बार देश के कोड द्वारा कुंजीबद्ध करें।
- त्रुटि हैंडलिंग: गैर-2xx स्थिति कोड और टाइमआउट को संभालें। खोज के लिए, सुझाव दिखाने या उपयोगकर्ता से क्वेरी को परिष्कृत करने के लिए कहें।
- कोटा और परीक्षण: पहली API में 7-दिन का परीक्षण या 50 अनुरोध शामिल हैं। वर्तमान पहुंच विकल्पों और परीक्षण के बाद की कीमतों के लिए, API पृष्ठ की जांच करें।
कंक्रीट खेल उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं
1) ऑनबोर्डिंग प्रवाह: अपना खेल चुनें
Get all sports को कॉल करें ताकि प्रारंभिक रुचि चयन को भर सकें या अपने आवेदन के कवरेज का स्कोप कर सकें। खेल id और slug को बनाए रखें ताकि डाउनस्ट्रीम सुविधाएँ (जैसे, फीड, प्रतियोगिताएँ) उन खेलों के भीतर रह सकें।
2) टीम खोजें और हल करें
Search all entities का उपयोग करें जिसमें q उपयोगकर्ता के इनपुट के बराबर हो। उदाहरण के लिए, एक उपयोगकर्ता "रियल मैड्रिड" टाइप करता है: खोज एंडपॉइंट को कॉल करें और शीर्ष परिणाम प्रस्तुत करें। रूटिंग या डेटाबेस संबंधों के लिए लौटाए गए entity.id और entity.slug को स्टोर करें। यदि आपको अपने UI में एक क्रीस्ट की आवश्यकता हो, तो entity.imagePath का उपयोग करें।
3) सूचियों और मैच हेडर में देश के झंडे
जब टीम की सूचियाँ या अंतरराष्ट्रीय मैचों को प्रदर्शित करते हैं, तो Get country flag के माध्यम से अल्फा-शैली कोड द्वारा देश के झंडे प्राप्त करें। छवि बाइट्स को कैश करें (जैसे, S3 या आपका CDN) कोड द्वारा कुंजीबद्ध करें ताकि आप बार-बार एक ही संपत्ति को पुनः प्राप्त न करें।
4) प्रशासनिक टैगिंग और सामग्री प्रबंधन
संपादकीय टीमें खेलों के अनुसार लेखों और वीडियो को टैग करने के लिए खेल कैटलॉग का उपयोग कर सकती हैं। Search all entities एक टाइपहेड को शक्ति दे सकता है ताकि आपके CMS में सुसंगत संस्थान IDs सुनिश्चित हो सकें, जिससे डुप्लिकेट टीम रिकॉर्ड को रोका जा सके।
5) AI सहायक जो खेल संस्थाओं को जानते हैं
जब एक AI एजेंट को एक टीम का संदर्भ देने वाला उपयोगकर्ता अनुरोध प्राप्त होता है, तो Search all entities को कॉल करें ताकि अस्पष्टता को हल किया जा सके और प्रतिक्रिया तैयार करने या अपने स्टैक में कहीं और अधिक विवरण प्राप्त करने से पहले मानक IDs और छवि पथ प्राप्त किए जा सकें।
एंडपॉइंट विवरण और एकीकरण टिप्स
सभी खेल प्राप्त करें
चूंकि कोई अनुरोध पैरामीटर नहीं हैं, आपका एकीकरण सीधा है: प्राधिकरण हेडर के साथ URL पर GET भेजें और JSON सरणी को पार्स करें। स्थिर कुंजियों के लिए स्लग को लोअरकेस में सामान्यीकृत करें। यदि आपका ऐप केवल खेलों के एक उपसमुच्चय का समर्थन करता है, तो एक बार सरणी को फ़िल्टर करें और एक स्थानीय सूची बनाए रखें।
सभी संस्थाओं की खोज करें
- पैरामीटर q आवश्यक है और इसे URL-कोडित किया जाना चाहिए। उपयोगकर्ता इनपुट को ट्रिमिंग और सामान्यीकरण (जैसे, कई स्थानों को संकुचित करना) बनाए रखें।
- प्रतिक्रिया में संस्थान मेटाडेटा शामिल है; उपयोगकर्ता चयन को आपके आंतरिक रिकॉर्ड से लिंक करने के लिए लौटाए गए IDs को स्टोर करें। कई सिस्टम एक स्थानीय मैपिंग तालिका बनाते हैं: external_id (SofaScore) -> internal_id।
- टाइपहेड: उपयोगकर्ताओं के टाइप करते समय ओवरफेचिंग से बचने के लिए UI में अनुरोधों को डिबाउंस करें; केवल तब कॉल करें जब क्वेरी की लंबाई ≥ 2–3 हो।
देश का झंडा प्राप्त करें
- पैरामीटर country_code आवश्यक है। उदाहरण में EN का उपयोग किया गया है। आप जिन कोडों को अनुरोध करने की योजना बना रहे हैं, उन्हें मान्य करें और अनुपस्थित कोड को सुचारू रूप से संभालें।
- चूंकि प्रतिक्रिया एक छवि की बाइट्स है, कच्चे बाइट्स को बनाए रखें या सुविधाजनक स्थान पर स्टोरेज के लिए बेस64 में परिवर्तित करें। ब्राउज़रों को सर्व करते समय, छवि प्रारूप के आधार पर सही Content-Type (जैसे, image/png) सेट करें।
- प्रदर्शन के लिए, पहले फ़ेच के बाद अपने स्थिर संपत्तियों या CDN में झंडों को स्टोर करें ताकि UI की विलंबता कम हो सके।
AI एजेंटों से MCP के माध्यम से API कॉल करें
यदि आप MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) का उपयोग करते हैं, तो आप MCP एंडपॉइंट और अपनी Zyla API कुंजी के माध्यम से कॉल रूट कर सकते हैं। अपने उपकरण को MCP पर apikey=YOUR_API_KEY के साथ पॉइंट करें। आपका एजेंट फिर SofaScore - लाइव API के लिए समान प्रलेखित हब URLs को सक्रिय कर सकता है। यह सहायक के लिए उपयोगी है जिन्हें:
- खेलों की सूची बनाना और एक डेवलपर को कॉन्फ़िगरेशन चरणों का प्रस्ताव देना।
- चैट सत्र के दौरान (खोज के माध्यम से) संस्थाओं के नामों को हल करना।
- जनित UI कोड या दस्तावेज़ में एम्बेड करने के लिए झंडे प्राप्त करना।
अपने उपकरण के HTTP कॉल में वही Authorization हेडर बनाए रखें। विकास के दौरान कॉल और प्रतिक्रियाओं को लॉग करें ताकि आप प्रॉम्प्ट लॉजिक या फॉलबैक व्यवहार को ट्यून कर सकें जब खोज अस्पष्ट हो।
सुरक्षा, तैनाती, और परीक्षण चेकलिस्ट
- पर्यावरण चर: अपने गुप्त प्रबंधक या CI/CD चर में YOUR_API_KEY स्टोर करें।
- टाइमआउट और पुनः प्रयास: संवेदनशील टाइमआउट (10–15 सेकंड) का उपयोग करें और idempotent GETs के लिए एकल पुनः प्रयास पर विचार करें।
- इनपुट मान्यता: खोज के लिए q को साफ करें और कॉल करने से पहले country_code को मान्य करें।
- निगरानी: स्थिति कोड और विलंबता लॉग करें; ऊंचे 4xx/5xx दरों पर अलर्ट करें।
- कैश रणनीति:
- खेल कैटलॉग: दैनिक या तैनाती पर रिफ्रेश करें।
- खोज: सामान्य क्वेरीज़ को मेमोइज़ करें या प्रति-सेशन कैश करें ताकि चर्न को कम किया जा सके।
- झंडे: स्थायी कैश/CDN स्टोरेज; शायद ही अमान्य करें।
त्वरित संदर्भ
- सभी खेल प्राप्त करें:
- GET https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports
- हेडर: Authorization: Bearer YOUR_API_KEY
- पैरामीटर्स: कोई नहीं
- सभी संस्थाओं की खोज करें:
- GET https://zylalabs.com/api/12787/sofascore-live-api/25082/search-all-entities
- हेडर: Authorization: Bearer YOUR_API_KEY
- पैरामीटर्स: q (string, आवश्यक), उदाहरण के लिए, रियल मैड्रिड
- देश का झंडा प्राप्त करें:
- GET https://zylalabs.com/api/12787/sofascore-live-api/31197/get-country-flag
- हेडर: Authorization: Bearer YOUR_API_KEY
- पैरामीटर्स: country_code (string, आवश्यक), उदाहरण के लिए, EN
FAQ
मैं अनुरोधों को प्रमाणित कैसे करूं?
Zyla Hub URLs पर प्रत्येक अनुरोध के साथ हेडर Authorization: Bearer YOUR_API_KEY भेजें।
“देश का झंडा प्राप्त करें” क्या लौटाता है?
प्रतिक्रिया शरीर झंडे की छवि बाइट्स है। इसे बाइनरी डेटा के रूप में मानें। यदि आप इसे प्रॉक्सी या स्टोर करते हैं, तो ग्राहकों को सर्व करते समय उचित छवि सामग्री प्रकार सेट करें।
क्या मैं खेलों की सूची कैश कर सकता हूँ?
हाँ। सूची अक्सर नहीं बदलती। इसे अपने ऐप में कैश करें (जैसे, दैनिक) ताकि प्रारंभिक गति बढ़ सके और कोटा बच सके।
मुझे Search all entities में कौन सा क्वेरी पास करना चाहिए?
उपयोगकर्ता की खोज स्ट्रिंग को q पैरामीटर (URL-कोडित) के माध्यम से पास करें, उदाहरण के लिए q=real+madrid। अपने सिस्टम में स्थिर संदर्भों के लिए लौटाए गए संस्थान ids और slugs का उपयोग करें।
क्या कोई मुफ्त योजना है?
पहली API में 7-दिन का परीक्षण या 50 अनुरोध शामिल हैं ताकि आप जल्दी से मूल्यांकन कर सकें। परीक्षण के बाद वर्तमान पहुंच विकल्पों और कीमतों के लिए, API पृष्ठ की जांच करें।
इसे भेजें
आपके पास अब खेल फ़िल्टर, संस्थाओं की खोज, और देश के झंडों को शक्ति देने के लिए आवश्यक एंडपॉइंट्स और कोड हैं। अपना खाता बनाएं और लिस्टिंग पर सीधे 7-दिन का परीक्षण शुरू करें: SofaScore - लाइव API पर 7-दिन का परीक्षण शुरू करें. आप zylalabs.com पर एक ही स्थान पर सब कुछ प्रबंधित कर सकते हैं और अपने AI उपकरणों से MCP के माध्यम से समान एंडपॉइंट्स को कॉल कर सकते हैं।