सोफास्कोर का उपयोग कैसे करें - लाइव एपीआई

आपको एक खेल एकीकरण भेजने की आवश्यकता है जो: सभी समर्थित खेलों की सूची बना सके, नाम द्वारा टीमों/लीगों/खिलाड़ियों की खोज कर सके, और बिना छवि संपत्तियों को खोजे देश के झंडे दिखा सके। इस गाइड के अंत तक आप ज़ाइला एपीआई हब पर सोफास्कोर - लाइव एपीआई को कॉल करेंगे ताकि आप ठीक यही कर सकें, साथ ही ऐसे कॉपी-पेस्ट करने योग्य अनुरोध जो आप इस सप्ताह उत्पादन में डाल सकते हैं।

यह एपीआई क्या करता है और इसका उपयोग कब करें

ज़ाइला एपीआई हब पर सोफास्कोर - लाइव एपीआई तीन मुख्य क्षमताएँ प्रदान करता है जिन्हें आप स्कोरबोर्ड, खोज प्रवाह और यूआई घटकों में जोड़ सकते हैं:

• सभी खेल प्राप्त करें: ऐप बूटस्ट्रैपिंग और फ़िल्टर के लिए समर्थित खेलों (id, name, slug) की गणना करें।
• सभी संस्थाओं की खोज करें: सोफास्कोर संस्थाओं (जैसे, टीमें) को स्वतंत्र पाठ द्वारा क्वेरी करें ताकि खोज बार और ऑटो-कम्प्लीट को शक्ति मिल सके।
• देश का झंडा प्राप्त करें: एक देश के झंडे के लिए कच्चे छवि बाइट्स लाएँ, जब टीम या खिलाड़ी की राष्ट्रीयता दिखाते समय उपयोगी।

यह एकल ज़ाइला सदस्यता और कुंजी के माध्यम से वितरित किया गया है, जिसमें अंत बिंदुओं के बीच एक सुसंगत प्राधिकरण हेडर है। ज़ाइला एक खाते और एक एपीआई कुंजी के पीछे 10,000 से अधिक सार्वजनिक एपीआई होस्ट करता है, ताकि आप बाद में बिना प्रमाणीकरण प्रवाह को फिर से काम किए बिना अधिक खेल और गेमिंग डेटा जोड़ सकें। कैटलॉग का अन्वेषण करें zylalabs.com पर।

ज़ाइला एपीआई हब पर शुरुआत करना

ज़ाइला एपीआई हब पर सोफास्कोर - लाइव एपीआई पृष्ठ खोलें और सदस्यता लें। आपके खाते पर पहला एपीआई 7-दिन की परीक्षण अवधि या 50 अनुरोधों को शामिल करता है, और बिलिंग एक सदस्यता + कोटा मॉडल का उपयोग करती है (पे-पर-कॉल नहीं)। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए, सीधे एपीआई पृष्ठ की जांच करें। सदस्यता लेने के बाद आपको एक एपीआई कुंजी प्राप्त होगी।

नीचे सभी अनुरोधों में यह हेडर शामिल है:

• Authorization: Bearer YOUR_API_KEY

आप आज जिन अंत बिंदुओं को जोड़ सकते हैं

1) सभी खेल प्राप्त करें

इस अंत बिंदु का उपयोग नेविगेशन, फ़िल्टर या ऑनबोर्डिंग के लिए एक स्थिर खेल सूची को भरने के लिए करें। यह id, name, और slug के साथ खेलों का एक एरे लौटाता है।

• Method: GET
• URL: https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports
• Parameters: कोई दस्तावेज नहीं
• Auth: 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"

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: प्रत्येक खेल के लिए स्थिर संख्यात्मक पहचानकर्ता (DB में स्टोर करें; फ़िल्टर के लिए उपयोग करें)।
• name: मानव-पठनीय लेबल (यूआई में प्रदर्शित करें)।
• slug: URL-अनुकूल पहचानकर्ता (मार्गों या कैनोनिकल कुंजी के लिए उपयोग करें)।

Python उदाहरण (अनुरोध):

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports"
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, headers=headers, timeout=10)
resp.raise_for_status()
sports = resp.json()

# Build a mapping and print a sorted menu
slug_by_id = {s["id"]: s["slug"] for s in sports}
menu = [f'{s["id"]}: {s["name"]} ({s["slug"]})' for s in sports]
print("\n".join(sorted(menu, key=lambda x: x.lower())))

# Example: pick the football sport id
football_id = next((s["id"] for s in sports if s["slug"] == "football"), None)
print("football_id =", football_id)

2) सभी संस्थाओं की खोज करें

इसका उपयोग सोफास्कोर संस्थाओं की स्वतंत्र-पाठ क्वेरी स्ट्रिंग (जैसे, टीम नाम) द्वारा खोजने के लिए करें। यह ऑटो-कम्प्लीट और "टीम पर कूदें" सुविधाओं के लिए आदर्श है।

• Method: GET
• URL: https://zylalabs.com/api/12787/sofascore-live-api/25082/search-all-entities
• Parameters:
  • q (string, आवश्यक): खोज शब्द। उदाहरण: रियल मैड्रिड
• Auth: Authorization: Bearer YOUR_API_KEY

cURL:

उदाहरण प्रतिक्रिया (हब द्वारा प्रदान किया गया अंश):

[{"entity":{"id":2829,"name":"Real Madrid","slug":"real-madrid","imagePath":"https:\/\/img.sofascore.com\/api\/v1\/team\/2829\/image","proxyImagePath":"https:\/\/betting.asdasddsgdfgfdsgfj.website\/sofascore\/image-proxy?imagePath=https:\/\/img.sofascore.com\/api\/v1\/team\/2829\/image","fullName":null,"shortName":null,"nameCode":"RMA","gender":"M","country":{"name":"Spain","slug":"spain","alpha2":"ES","alpha3":null,"imagePath":"https:\/\/img.sofascore.com\/api\/v1\/country\/ES\/flag","proxyImagePath":"https:\/\/betting.asdasddsgdfgfdsgfj.website\/sofascore\/image-proxy?imagePath=https:\/\/img.sofascore.com\/api\/v1\/country\/ES\/flag"},"foundationDateTimestamp":null,"manager":[],"ranking":null,"national":false,"venue":[],"sport":{"id":1,"name":"Football","slug":"football"}},"score":4293164.5,"type":"team"},{"entity":{"id":2816,"name":"Real Betis","slug":"real-betis","imagePath":"https:\/\/img.sofascore.com\/api\/v1\/team\/2816\/image","proxyImagePath":"https:\/\/betting.asdasddsgdfgfdsgfj.website\/sofascore\/image-proxy?imagePath=https:\/\/img.sofascore.com\/api\/v1\/team\/2816\/image","fullName":null,"shortName":null,"nameCode":"BET","gender":"M","country":{"name":"Spain","slug":"spain","alpha2":…

कार्यान्वयन के लिए नोट्स:

• entity.id, entity.name, entity.slug, और type को पढ़ें ताकि परिणामों को वर्गीकृत किया जा सके (जैसे, टीम बनाम अन्य प्रकार)।
• प्रतिक्रिया में छवि यूआरएल शामिल हैं जिन्हें आप आवश्यकता अनुसार प्रॉक्सी कर सकते हैं; अपने यूआई के अनुसार जैसा है वैसा उपयोग करें।
• तेज़ यूआई के लिए, क्वेरी को डिबाउंस करें और हाल की परिणामों को q द्वारा की गई कुंजी के अनुसार कैश करें।

3) देश का झंडा प्राप्त करें

देश के झंडे की छवि बाइट्स लाएँ। बिना अपने संपत्ति भंडार को बनाए रखे खिलाड़ी या टीम के देश के झंडे को दिखाने के लिए उपयोगी।

• Method: GET
• URL: https://zylalabs.com/api/12787/sofascore-live-api/31197/get-country-flag
• Parameters:
  • country_code (string, आवश्यक): EN
• Auth: Authorization: Bearer YOUR_API_KEY

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…

कार्यान्वयन टिप्स:

• प्रतिक्रिया छवि डेटा है; आवश्यकता अनुसार इसे अपने फ्रंटेंड में स्टोर या स्ट्रीम करें।
• दोहराए गए डाउनलोड से बचने के लिए अपने सीडीएन या ऑब्जेक्ट स्टोर में झंडों को कैश करें।

इसे एक साथ रखना: सामान्य एकीकरण पैटर्न

• बूटस्ट्रैप फ़िल्टर: ऐप प्रारंभ के दौरान सभी खेलों को प्राप्त करने के लिए कॉल करें, id/name/slug को स्टोर करें, और सूची को ड्रॉपडाउन में प्रदर्शित करें।
• खोज बार: उपयोगकर्ता इनपुट पर, q के साथ सभी संस्थाओं की खोज करें। 250–400 मिलीसेकंड द्वारा डिबाउंस करें, कॉल को कम करने के लिए क्वेरी द्वारा कैश करें।
• राष्ट्रीय झंडे: जब टीम या खिलाड़ी कार्ड प्रदर्शित करते हैं, तो कोड के लिए एक बार देश का झंडा प्राप्त करें और परिणाम को कैश करें; पृष्ठों के बीच कैश से पुन: उपयोग करें।

प्रमाणीकरण और अनुरोध स्वच्छता

• हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
• खेलों की सूची को अपेक्षाकृत स्थिर मानें; इसे कभी-कभी पृष्ठभूमि में ताज़ा करें और स्थानीय रूप से स्टोर करें।
• बुनियादी त्रुटि हैंडलिंग पथ बनाएं: नेटवर्क टाइमआउट, गैर-200 स्थिति, और खोज से खाली एरे।

AI एजेंटों से इस एपीआई को MCP के माध्यम से कॉल करें

यदि आप AI कोडिंग एजेंटों (जैसे, MCP-संगत IDE और उपकरण) का उपयोग करते हैं, तो आप ज़ाइला MCP ब्रिज के माध्यम से समान अंत बिंदुओं को कॉल कर सकते हैं। अपने क्लाइंट को MCP अंत बिंदु पर इंगित करें और क्वेरी स्ट्रिंग में अपनी ज़ाइला एपीआई कुंजी प्रदान करें। विवरण के लिए, देखें MCP. एजेंट तब ऊपर दिखाए गए समान GET अनुरोध कर सकता है, हब यूआरएल और प्राधिकरण हेडर का उपयोग करते हुए।

समय बचाने वाले परिचालन नोट्स

• Idempotence: दस्तावेज़ित अंत बिंदु GET हैं; वे अस्थायी विफलताओं पर पुनः प्रयास करने के लिए सुरक्षित हैं।
• क्लाइंट कैशिंग: मेमोरी में सभी खेलों को प्राप्त करें और एक हल्के डेटा स्टोर में स्थायी रूप से स्टोर करें; ऐप स्टार्टअप पर ताज़ा करें।
• बाइनरी डेटा हैंडलिंग: झंडा अंत बिंदु छवि बाइट्स लौटाता है। ब्राउज़रों को प्रॉक्सी करते समय, अपने वातावरण के अनुसार हेडर सेट करें ताकि क्लाइंट को जैसा इरादा हो, उसे रेंडर या डाउनलोड कर सके।
• उपयोग योजना: ज़ाइला एपीआई सदस्यता + कोटा का उपयोग करते हैं। आपके खाते पर पहला एपीआई 7-दिन की परीक्षण अवधि या 50 अनुरोधों को शामिल करता है; लोड परीक्षण से पहले एपीआई पृष्ठ पर अपने वर्तमान कोटा की पुष्टि करें।

गहरे गोताखोरी उदाहरण

खोज: सुझाव सूची के लिए परिणामों को आकार देना

खोज अंत बिंदु को कॉल करने के बाद, प्रत्येक परिणाम के लिए एक हल्का प्रक्षिप्ति निकालें:

• id: संख्यात्मक संस्थान id
• label: entity.name
• type: प्रकार (जैसे, टीम) परिणामों को बैज करने के लिए
• sport: entity.sport.slug स्कोपिंग के लिए
• country: जब मौजूद हो तो entity.country.alpha2; यदि आपको एक झंडा चाहिए, तो आवश्यक country_code पैरामीटर के साथ Get country flag को कॉल करें

यह प्रक्षिप्ति कॉम्पैक्ट है और आपके यूआई को तेज रखती है।

झंडे: ब्राउज़र को सेवा देना

जब आपका बैकएंड Get country flag से छवि बाइट्स प्राप्त करता है, तो आप:

• बाइट्स को ऑब्जेक्ट स्टोरेज में PNG के रूप में स्टोर करें और सामान्यीकृत कुंजी (जैसे, flag-EN.png) द्वारा CDN-कैश करें।
• यदि आप शून्य-राउंडट्रिप रेंडर चाहते हैं तो अपने फ्रंटेंड को डेटा यूआरआई लौटाएँ; HTML पेलोड के लिए आकार के प्रभावों पर ध्यान दें।

पूर्ण संदर्भ

सभी खेल प्राप्त करें

• GET https://zylalabs.com/api/12787/sofascore-live-api/25080/get-all-sports
• Params: कोई दस्तावेज नहीं
• Auth: Authorization: Bearer YOUR_API_KEY

सभी संस्थाओं की खोज करें

• GET https://zylalabs.com/api/12787/sofascore-live-api/25082/search-all-entities
• Params:
  • q (string, आवश्यक): खोज क्वेरी
• Auth: Authorization: Bearer YOUR_API_KEY

देश का झंडा प्राप्त करें

• GET https://zylalabs.com/api/12787/sofascore-live-api/31197/get-country-flag
• Params:
  • country_code (string, आवश्यक): EN
• Auth: Authorization: Bearer YOUR_API_KEY

अक्सर पूछे जाने वाले प्रश्न

मैं अनुरोधों को कैसे प्रमाणित करूँ?
हर कॉल पर हेडर शामिल करें: Authorization: Bearer YOUR_API_KEY हब यूआरएल पर।

क्या कोई मुफ्त योजना है?
मॉडल सदस्यता + कोटा है। ज़ाइला पर आपके पहले एपीआई के लिए, आपको 7-दिन की परीक्षण अवधि या 50 अनुरोध मिलते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।

क्या मैं खोज से परिणामों को पेजिनेट कर सकता हूँ?
पैजिनेशन विवरण यहाँ दस्तावेजित नहीं हैं। प्रदान किए गए खोज अंत बिंदु का उपयोग करें और लौटाए गए एरे को जैसा है वैसा संभालें।

झंडा अंत बिंदु कौन सा प्रारूप लौटाता है?
यह छवि बाइट्स लौटाता है। नमूना एक PNG-जैसे बाइट स्ट्रीम को दिखाता है। अपनी ऐप के लिए उपयुक्त रूप से स्टोर या सेवा करें।

मुझे खेलों की सूची से कौन से फ़ील्ड को स्थायी रूप से रखना चाहिए?
id, name, और slug को स्थायी रूप से रखें। id एक अच्छा स्थिर कुंजी है; name और slug का उपयोग यूआई और रूटिंग में किया जाता है।

क्या आप इसे अपने ऐप में जोड़ने के लिए तैयार हैं? ज़ाइला पर एक मुफ्त खाता बनाएं, अपनी कुंजी प्राप्त करें, और सोफास्कोर - लाइव एपीआई के साथ निर्माण शुरू करें। यहाँ से शुरू करें: सोफास्कोर - लाइव एपीआई पर 7-दिन की परीक्षण अवधि शुरू करें. आप हमेशा बाद में zylalabs.com पर अधिक खेल और गेमिंग एपीआई का अन्वेषण कर सकते हैं।