इसका उपयोग कौन कर सकता है?
वे लीग जो Gold प्लान पर हैं और जिन्होंने API चालू किया है। इसे चालू करने के लिए एडमिन होम > API > API सेटिंग्स पर जाएं और JSON API सक्षम करें पर टिक करें। इनमें से कुछ भी न हो, तो इन लेखों में दिया हर वेब पता आपके डेटा की जगह एरर देता है।
यह क्या है?
API किसी दूसरी वेबसाइट, ऐप या प्रोग्राम को आपकी लीग के मैच, नतीजे और टेबल सीधे LeagueRepublic से पढ़ने देता है। इसे वेटर की तरह समझिए: आपकी वेबसाइट कुछ मांगती है ("आज के मैच दीजिए"), और LeagueRepublic जवाब लाकर देता है।
आप कैसे मांगते हैं?
आप किसी वेब पेज को खोलने की तरह ही एक वेब पता खोलते हैं। सुंदर दिखने वाले पेज की जगह आपको JSON नाम के फ़ॉर्मैट में सादा टेक्स्ट मिलता है। आपके वेब डेवलपर का कोड, या किसी AI असिस्टेंट का बनाया पेज, उस टेक्स्ट को पढ़ता है और उसे आपके डिज़ाइन के अनुसार दिखाता है।
JSON कैसा दिखता है?
यह लेबल और वैल्यू की एक सूची है, कुछ-कुछ भरे हुए फ़ॉर्म जैसी:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
कोलन से पहले का शब्द फ़ील्ड नाम है (फ़ॉर्म पर लगा लेबल)। उसके बाद का हिस्सा वैल्यू है (खाने में जो लिखा गया)। API स्पेसिफ़िकेशन बताता है कि हर फ़ील्ड नाम का क्या मतलब है।
ID क्या है?
LeagueRepublic में हर लीग, सीज़न, डिवीज़न, टीम और मैच का अपना एक नंबर होता है, जिसे ID कहते हैं। यह सदस्यता नंबर जैसा है: यह कभी नहीं बदलता, और दो चीज़ों का एक ही नंबर नहीं होता। आप वेब पते में ID डालकर बताते हैं कि आपको कौन-सा सीज़न या कौन-सी टीम चाहिए।
मुझे अपनी ID कैसे मिलेंगी?
आपकी लीग ID एडमिन होम > API > API सेटिंग्स पर दिखती है।
आपकी सीज़न ID: अपने ब्राउज़र में यह पता खोलें, और [MY-LEAGUE-ID] की जगह अपनी लीग ID डालें। इसमें आपके सीज़न की सूची होती है, हर एक की ID के साथ।
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
डिवीज़न और टीम की ID API की भेजी सूचियों में दिखती हैं। अगर आप बनाएं… वाले किसी लेख का उपयोग करते हैं, तो AI असिस्टेंट ये आपके लिए खुद ढूंढ लेता है।
क्या कोई सीमा है?
हां। हर लीग एक मिनट में सिर्फ़ एक तय संख्या तक अनुरोध कर सकती है, और यह सीमा आपकी लीग के डेटा का उपयोग करने वाली हर चीज़ में बंटती है: आपकी वेबसाइट, ऐप और बाकी सब। अच्छी तरह बना पेज जो लोड करता है उसे सेव कर लेता है, बार-बार दोबारा नहीं मांगता। सटीक सीमा API स्पेसिफ़िकेशन में दी गई है।
कुछ शब्द जो आपको दिखेंगे
Road – मेहमान टीम। ज़्यादातर लोग जिसे "away" कहते हैं, LeagueRepublic उसे "road" कहता है।
Fixture – एक मैच, चाहे वह खेला जा चुका हो या नहीं।
Fixture group – एक डिवीज़न (जैसे "Premier Division"), एक कप, या मैचों का कोई और समूह।
Result – वह फ़िक्सचर जिसका स्कोर आ चुका है।
null – खाना खाली है। लीग ने उसे दर्ज नहीं किया, या वह लागू नहीं होता।
true / false – हां / नहीं।
पूरी जानकारी कहां है?
सारी सटीक जानकारी, जैसे हर फ़ील्ड नाम, सीमा और एरर मैसेज, API स्पेसिफ़िकेशन में है: