फ़ुटबॉल डेटा, एक साफ़ REST API।
आपकी अपनी दुनिया के क्लब, खिलाड़ी, तालिकाएँ और मैच, JSON के रूप में - वही फ़ुटबॉल जिसमें आपकी लीग खेली जा रही है, उसके साथ चलता हुआ। केवल पढ़ने के लिए, और सदस्यता का हिस्सा।
एंडपॉइंट
छह संसाधन परिवार, एक बेस URL।
तीन चरणों में शुरू करें
एक कुंजी बनाएँ
सदस्य के रूप में, चुनें कि API आपकी कौन सी दुनिया पढ़े और अपने API हब पृष्ठ पर एक कुंजी बनाएँ।
एक एंडपॉइंट कॉल करें
कुंजी को bearer token के रूप में भेजें। हर संसाधन अनुमानित पेजिनेशन वाला सादा JSON है।
जारी करें
जब तक आप सदस्य हैं, पहली कॉल से आख़िरी तक वही सीमा और वही एंडपॉइंट।
सदस्यता का हिस्सा।
हर एंडपॉइंट, दिन में 100 अनुरोध, आपके द्वारा मैनेज की जाने वाली एक दुनिया के लिए। कोई अलग प्लान नहीं और प्रति अनुरोध कोई बिल नहीं - सर्वर का ख़र्च उठाने वाली सदस्यता ही API खोलती है।
गिनती 00:00 UTC पर रीसेट होती है, और उससे ज़्यादा होने पर Retry-After हेडर के साथ 429 लौटता है। अगर आपकी सदस्यता समाप्त होती है, तो आपकी कुंजियाँ हटाने के बजाय निलंबित की जाती हैं, और नवीनीकरण करते ही फिर काम करती हैं।
समझदारी से इस्तेमाल करें
जो नहीं बदलता उसे कैश करें - क्लब, प्रतियोगिताएँ और स्क्वॉड दिन में ज़्यादा से ज़्यादा एक बार बदलते हैं - और बार-बार पूछने के बजाय वही माँगें जो चाहिए। सही अनुरोध हों तो दिन में 100 काफ़ी हैं।
सवाल
इसकी कीमत क्या है?
यह सदस्यता के साथ आता है। कोई अलग API प्लान नहीं और प्रति अनुरोध कोई बिल नहीं।
यह केवल सदस्यों के लिए क्यों है?
API कॉल का जवाब देने में सर्वर का ख़र्च आता है, और सदस्यता ही उसका भुगतान करती है। एक कुंजी वही सार्वजनिक फ़ुटबॉल पढ़ती है जो वर्ल्ड ब्राउज़र सबको दिखाता है, इसलिए यह सदस्यों के लिए सुविधा है, किसी और पर बढ़त नहीं।
यह कौन सी दुनिया पढ़ता है?
एक दुनिया जिसमें आप क्लब मैनेज करते हैं, आपके API हब पृष्ठ पर चुनी गई। आपकी हर कुंजी वही दुनिया पढ़ती है, और आप कभी भी अपनी दूसरी दुनिया पर बदल सकते हैं।
क्या कुंजी कुछ बदल सकती है?
नहीं। हर एंडपॉइंट केवल पढ़ने वाला है। कुंजी किसी दुनिया को देख सकती है; वह कभी लाइन-अप तय नहीं कर सकती, बोली नहीं लगा सकती या आपके सेव को नहीं छू सकती।
अगर मेरी सदस्यता समाप्त हो जाए तो क्या होगा?
आपकी कुंजियाँ हटाने के बजाय निलंबित की जाती हैं: नवीनीकरण तक अनुरोध अस्वीकार होते हैं, और फिर वही कुंजियाँ आपकी ओर से बिना किसी बदलाव के फिर काम करती हैं।
अगर मैं सीमा से ज़्यादा जाऊँ तो क्या होगा?
अनुरोध Retry-After हेडर के साथ 429 लौटाते हैं। गिनती हर दिन 00:00 UTC पर रीसेट होती है।
क्या डेटा असली दुनिया का फ़ुटबॉल डेटा है?
यह Tactics11 ब्रह्मांड है - एक स्थायी, सिम्युलेटेड दुनिया। असली लीग डेटा के लाइसेंस के बिना आपके अपने टूल, बॉट और डैशबोर्ड के लिए बिल्कुल सही।