आपको उपयोगकर्ताओं को प्रतियोगिताओं (खेल और देश द्वारा) की एक साफ सूची दिखानी है और इसे इस सप्ताह अपने ऐप में शामिल करना है। इस गाइड के अंत तक, आप एक उत्पादन एंडपॉइंट को कॉल करेंगे जो प्रतियोगिता मेटाडेटा (आईडी, नाम, यूआरएल, ध्वज जैसे hasStandings और hasStats) लौटाता है, इसे पार्स करेंगे, और इसे अपने UI या बैकएंड वर्कफ़्लो में प्लग करेंगे।
आप 365Scores API के साथ क्या बनाएंगे
Zyla API Hub पर 365Scores API संरचित खेल डेटा लौटाता है जिसे आपका एप्लिकेशन तुरंत उपयोग कर सकता है। प्रतियोगिता खोज के लिए, आप एक एंडपॉइंट का उपयोग करेंगे जो एक दिए गए खेल और देश के लिए प्रतियोगिताओं को लाता है, जिसमें पहचानकर्ता शामिल हैं जिनकी आपको उपयोगकर्ताओं को अन्य स्थानों पर स्टैंडिंग, फिक्स्चर या आँकड़ों के लिए मार्गदर्शन करने की आवश्यकता होगी।
सामान्य उपयोगों में शामिल हैं:
- ऑनबोर्डिंग प्रवाह में देश और लीग पिकर्स।
- प्रतियोगिता आईडी को आंतरिक सामग्री मॉडल से मैप करने के लिए प्रशासनिक उपयोगिताएँ।
- प्रतियोगिताओं की सक्रिय सूची को दैनिक रूप से ताज़ा करने के लिए कैश वार्मर्स या CRON कार्य।
Zyla API Hub पर शुरू करना
API सूची खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें:
- 365Scores API पृष्ठ पर जाएँ Zyla API Hub पर और सदस्यता लें या मुफ्त परीक्षण शुरू करें।
- डैशबोर्ड से अपनी API कुंजी कॉपी करें। सभी अनुरोधों में Authorization: Bearer YOUR_API_KEY का उपयोग होता है।
- नीचे दिए गए प्रतियोगिता एंडपॉइंट के खिलाफ अपना पहला कॉल करें।
Zyla API Hub एक खाते और एक कुंजी के पीछे 10,000 से अधिक सार्वजनिक APIs को एकत्र करता है। उपयोग एक सदस्यता पर बिल किया जाता है जिसमें कोटा होता है (पे-पर-कॉल नहीं)। इस API के लिए, आप सूची पृष्ठ से 7-दिन का परीक्षण शुरू कर सकते हैं: 365Scores API पर 7-दिन का परीक्षण शुरू करें.
एंडपॉइंट: प्रतियोगिताएँ प्राप्त करें (खेल और देश द्वारा)
यह एंडपॉइंट खेल और देश द्वारा स्कोप की गई प्रतियोगिता डेटा लौटाता है। आप अपने UI में आईडी का उपयोग करेंगे और यह तय करने के लिए नाम/ध्वज संग्रहीत करेंगे कि क्या प्रदर्शित करना है (जैसे, क्या किसी लीग में स्टैंडिंग या आँकड़े हैं)।
- विधि: GET
- यूआरएल: https://zylalabs.com/api/13503/365scores-api/29728/get-competitions
- आवश्यक क्वेरी पैरामीटर:
- sportId
- countryId
- langId
- timezone
- प्रमाणीकरण: Authorization: Bearer YOUR_API_KEY
cURL जिसे आप कॉपी/पेस्ट कर सकते हैं
curl -s -X GET "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions?sportId=1&countryId=11&langId=1&timezone=Europe%2FBerlin" \
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक JSON प्रतिक्रिया
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…
आप वास्तव में जिन फ़ील्ड का उपयोग करेंगे
- competitions[].id: प्राथमिक कुंजी जिसे आप अपने सिस्टम में संग्रहीत और पास करेंगे।
- competitions[].name और longName: UI लेबल के लिए प्रदर्शित स्ट्रिंग।
- competitions[].hasStandings, hasStats, hasTransfers: UI सुविधाओं को शर्तों पर गेट करें।
- competitions[].currentSeasonNum और currentStageNum: सीजन-सचेत दृश्य के लिए संदर्भ।
- competitions[].nameForURL: सुंदर यूआरएल या स्लग के लिए उपयोगी।
- sports[0] और countries[0]: पुष्टि करें कि आपने जो स्कोप अनुरोध किया है (जैसे, पुर्तगाल में फुटबॉल)।
समय क्षेत्रों पर नोट: अनुरोध में timezone=Europe/Berlin शामिल है। अपने कॉल के बीच इसे सुसंगत रखें ताकि संबंधित एंडपॉइंट से मिलने वाले किसी भी डाउनस्ट्रीम दिनांक/समय फ़ील्ड संरेखित रहें। ऊपर दिया गया उदाहरण टाइमस्टैम्प शामिल नहीं करता है, लेकिन एक स्थिर समय क्षेत्र स्ट्रिंग का उपयोग आपके एकीकरण में एक अच्छा अभ्यास है।
Python उदाहरण: सक्रिय प्रतियोगिताओं को प्राप्त करें और फ़िल्टर करें
नीचे दिया गया स्निपेट उसी एंडपॉइंट को कॉल करता है, प्रमाणीकरण हेडर को लागू करता है, और एक कॉम्पैक्ट पेलोड प्रिंट करने से पहले निष्क्रिय प्रतियोगिताओं को फ़िल्टर करता है जिसे आप फ्रंट एंड को सौंप सकते हैं।
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions"
params = {
"sportId": "1",
"countryId": "11",
"langId": "1",
"timezone": "Europe/Berlin"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
competitions = data.get("competitions", [])
active = [c for c in competitions if c.get("isActive")]
# आपके UI के लिए न्यूनतम आकार
result = [
{
"id": c["id"],
"name": c.get("name") or c.get("longName"),
"slug": c.get("nameForURL"),
"hasStandings": c.get("hasStandings"),
"hasStats": c.get("hasStats"),
"season": c.get("currentSeasonNum"),
"stage": c.get("currentStageNum")
}
for c in active
]
print({
"sport": (data.get("sports") or [{}])[0].get("name"),
"country": (data.get("countries") or [{}])[0].get("name"),
"count": len(result),
"competitions": result[:5] # शीर्ष 5 का पूर्वावलोकन
})
समय बचाने वाले कार्यान्वयन नोट्स
- आईडी स्थिर कुंजी हैं: competitions[].id को अपने कैनोनिकल संदर्भ के रूप में संग्रहीत करें। नाम सीज़न के बीच बदल सकते हैं; स्लग (nameForURL) उपयोगी होते हैं लेकिन प्राथमिक कुंजी नहीं होते।
- फीचर फ्लैग: hasStandings, hasStats, hasTransfers आपको बिना अतिरिक्त एंडपॉइंट की जांच किए टैब छिपाने या दिखाने देते हैं।
- कैशिंग: देश-स्तरीय प्रतियोगिता सूचियाँ मिनट-से-मिनट नहीं बदलती हैं। घंटों के लिए कैश करें और जब आप तैनात करें या दैनिक कार्यक्रम पर अमान्य करें।
- स्थानीयकरण: क्लाइंट भाषा के लिए langId का लगातार उपयोग करें। यदि आप कई स्थानीयताओं का समर्थन करते हैं, तो (sportId, countryId, langId) के अनुसार परिणामों को कैश करें।
- समय क्षेत्र: अपने ऐप में समय क्षेत्र को सुसंगत रखें ताकि व्युत्पन्न तिथियों में सूक्ष्म भिन्नताएँ न हों। उदाहरण में Europe/Berlin का उपयोग किया गया है; एक रणनीति चुनें और उस पर टिके रहें।
चरण-दर-चरण: प्रतियोगिता विवरण को अपने ऐप में शामिल करना
1) अपने स्कोप का निर्णय लें
अपने उत्पाद लॉन्च स्कोप के लिए sportId और countryId चुनें। ऊपर दिए गए उदाहरण में, sportId=1 (फुटबॉल) और countryId=11 (पुर्तगाल) है। आप अपने एकीकरण में इन आईडी को आवश्यकतानुसार बदलकर विभिन्न देशों या खेलों को क्वेरी कर सकते हैं।
2) एंडपॉइंट को सर्वर-साइड पर कॉल करें
एक सुरक्षित बैकएंड से Authorization: Bearer हेडर भेजें। क्लाइंट-साइड कोड में YOUR_API_KEY को उजागर करने से बचें। प्रतिक्रिया में खेल, देश, और प्रतियोगिताओं के एरे शामिल होते हैं, जिन्हें आप अपने पृष्ठ मॉडल से मैप कर सकते हैं।
3) सामान्यीकरण और संग्रहण
प्रतियोगिता आईडी, नाम, स्लग, और ध्वज को स्थायी करें। अधिकांश टीमें न्यूनतम पंक्ति के साथ-साथ डिबगिंग के लिए कच्चा JSON संग्रहीत करती हैं।
4) अपने UI को रेंडर करें
अपने कैश से भरे देश और लीग चयनकर्ता को दिखाएँ। ध्वज का उपयोग करके शर्तों पर टैब रेंडर करें (जैसे, केवल तब “स्टैंडिंग” टैब दिखाएँ जब hasStandings सत्य हो)।
5) एक कार्यक्रम पर ताज़ा करें
अपने उपयोग के मामले के अनुसार एक ताल पर अपने कैश को फिर से बनाएं (जैसे, दैनिक)। अंतिम-अपडेटेड को मेटाडेटा में ट्रैक करें ताकि यदि किसी लीग सूची में पुराना लग रहा हो तो आप जल्दी से समस्या निवारण कर सकें।
आप अगला कौन सा संबंधित एंडपॉइंट उपयोग कर सकते हैं
यदि आपकी प्रतियोगिता दृश्य भी खिलाड़ी-केंद्रित पृष्ठों से लिंक करता है, तो ये एंडपॉइंट खिलाड़ी विवरण, मैच, और आँकड़े लौटाते हैं। ये प्रतियोगिता खोज से अलग हैं, लेकिन अक्सर एक ही उत्पाद क्षेत्रों में एक साथ सामने आते हैं।
खिलाड़ी विवरण प्राप्त करें
- विधि: GET
- यूआरएल: https://zylalabs.com/api/13503/365scores-api/29748/get-player-details
- पैरामीटर्स: playerId, langId, timezone
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…
खिलाड़ी मैच प्राप्त करें
- विधि: GET
- यूआरएल: https://zylalabs.com/api/13503/365scores-api/29749/get-player-matches
- पैरामीटर्स: playerId, langId, timezone
खिलाड़ी आँकड़े प्राप्त करें
- विधि: GET
- यूआरएल: https://zylalabs.com/api/13503/365scores-api/29750/get-player-stats
- पैरामीटर्स: playerId, langId, timezone
MCP के माध्यम से AI एजेंट से API कॉल करना
Zyla पर हर API को MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) से कॉल किया जा सकता है। अपने एजेंट को MCP एंडपॉइंट पर इंगित करें और उपकरण होस्ट को कॉन्फ़िगर करते समय अपनी कुंजी को क्वेरी पैरामीटर के रूप में प्रदान करें: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
एक बार कॉन्फ़िगर होने के बाद, आपका एजेंट आवश्यक पैरामीटर के साथ ऊपर देखे गए उसी प्रतियोगिता एंडपॉइंट को सक्रिय कर सकता है। MCP के बारे में दस्तावेज़ के लिए, देखें: MCP.
सामान्य समस्याएँ और समस्या निवारण
- 401 त्रुटियाँ: सुनिश्चित करें कि Authorization हेडर बिल्कुल Authorization: Bearer YOUR_API_KEY है, बिना किसी अतिरिक्त स्थान या योजनाओं के।
- खाली प्रतियोगिताएँ एरे: सुनिश्चित करें कि sportId और countryId आपके स्कोप के लिए मान्य हैं। यदि आपका प्रारंभिक संयोजन लीग नहीं लौटा रहा है तो एक अलग जोड़ी आज़माएँ।
- स्थानीयकरण असंगति: यदि आपका UI एक विशिष्ट भाषा में है, तो कॉल के बीच langId को सुसंगत रखें। भाषा के अनुसार परिणामों को कैश करें।
- समय क्षेत्र भिन्नताएँ: अन्य एंडपॉइंट जोड़ने पर मिश्रित UTC/स्थानीय व्यवहार से बचने के लिए एप्लिकेशन स्तर पर समय क्षेत्र को मानकीकरण करें।
वास्तविक दुनिया के एकीकरण पैटर्न
- सर्वर-रेंडर किए गए मेनू: ऐप बूट पर, प्रतियोगिताओं को लाएँ और देश के अनुसार एक लीग ड्रॉपडाउन रेंडर करें। केवल आईडी, नाम, स्लग, और फीचर फ्लैग्स को स्टोर करें।
- बैच इनजेस्ट: रात का कार्य उन देशों का पुनरावृत्ति करता है जिनका आप समर्थन करते हैं और प्रतियोगिता डेटा को आपके DB या KV स्टोर में ताज़ा करता है।
- फीचर-गेटेड पृष्ठ: यदि API फ्लैग्स किसी लीग के लिए कहते हैं कि वे संसाधन उपलब्ध नहीं हैं (hasStandings, hasStats) तो स्टैंडिंग या आँकड़ों के लिए लिंक न करें।
- डीप लिंकिंग: मानव-पठनीय स्लग बनाने के लिए nameForURL का उपयोग करें जबकि पीछे के दृश्यों में संख्यात्मक आईडी द्वारा रूटिंग करें।
अक्सर पूछे जाने वाले प्रश्न
क्या मैं खेल और देश बदल सकता हूँ?
हाँ। क्वेरी स्ट्रिंग में उपयुक्त sportId और countryId पास करें। उदाहरण में पुर्तगाल में फुटबॉल का उपयोग किया गया है; अपने स्कोप से मेल खाने के लिए आईडी को अपडेट करें।
क्या मुझे हर अनुरोध पर API कुंजी भेजने की आवश्यकता है?
हाँ। अपने सर्वर-साइड कोड से हर कॉल में Authorization: Bearer YOUR_API_KEY शामिल करें।
मुझे प्रतियोगिताओं की सूची को कितनी बार ताज़ा करना चाहिए?
प्रतियोगिता सूचियाँ मिनट-से-मिनट नहीं बदलती हैं। अधिकांश टीमें घंटों के लिए कैश करती हैं या दैनिक रूप से ताज़ा करती हैं। अपने उत्पाद की आवश्यकताओं के साथ मेल खाने वाली ताल का चयन करें।
यदि मुझे प्रतियोगिता दृश्य से जुड़े खिलाड़ी पृष्ठों की आवश्यकता है तो क्या होगा?
खिलाड़ी एंडपॉइंट का उपयोग करें जो ऊपर दिखाए गए हैं (विवरण, मैच, आँकड़े) खिलाड़ी-विशिष्ट पृष्ठों या मोडलों को भरने के लिए। ये प्रतियोगिता खोज से अलग कॉल हैं।
क्या कोई मुफ्त योजना है?
एक्सेस विकल्प बदल सकते हैं। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जाँच करें। आप मार्केटप्लेस सूची से 7-दिन का परीक्षण शुरू कर सकते हैं।
प्रतियोगिता विवरण भेजने के लिए तैयार हैं? सदस्यता लें और Zyla API Hub पर 365Scores API सूची से अपनी कुंजी प्राप्त करें: 365Scores API पर 7-दिन का परीक्षण शुरू करें. फिर cURL या Python नमूने को अपने बैकएंड में डालें, परिणामों को कैश करें, और अपने UI को रोशन करें।
आधिकारिक API प्रतिक्रिया
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…