NRL API को JavaScript में Zyla API Hub का उपयोग करके एकीकृत करें (गाइड)

आपको इस सप्ताह एक NRL स्टैंडिंग और शेड्यूल विजेट भेजने की आवश्यकता है। इस गाइड के अंत तक आप JavaScript फेच का उपयोग करके Zyla API Hub से NRL API को क्वेरी करेंगे, एक सीज़न के लिए वर्तमान सीढ़ी को रेंडर करेंगे, एक दिए गए राउंड के लिए फिक्स्चर खींचेंगे, और एक विशेष मैच के विवरण में गहराई से जाएंगे—आपके ऐप या डैशबोर्ड में डालने के लिए तैयार।

Zyla API Hub पर NRL API के साथ आपको क्या मिलता है

NRL API संरचित रग्बी लीग डेटा प्रदान करता है जिसे आप अपने फ्रंटेंड या बैकेंड से सीधे उपभोग कर सकते हैं:

Illustration: Integrate the NRL API in JavaScript Using Zyla API Hub (Guide)

सीढ़ी: उस सीज़न के लिए वर्तमान स्टैंडिंग जिसे आप चुनते हैं (वर्तमान वर्ष और 2002 तक का समर्थन करता है)।
फिक्स्चर: उस राउंड के लिए खेल का कार्यक्रम और स्कोर जिसे आप चुनते हैं (वर्तमान सीज़न और 2002 तक)।
मैच विवरण: फिक्स्चर एंडपॉइंट से एक मैच आईडी के लिए गहन जानकारी, जिसमें स्कोर और लाइनअप शामिल हैं।

यह Zyla API Hub मार्केटप्लेस पर सूचीबद्ध है, जो एक ही खाते, एक API कुंजी और एक सदस्यता मॉडल के तहत 10,000 से अधिक सार्वजनिक APIs को एकत्र करता है। आप यहाँ NRL API लिस्टिंग ब्राउज़ कर सकते हैं: NRL API.

Zyla API Hub पर शुरुआत करना

सेटअप में कुछ मिनट लगते हैं:

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

सभी कॉल्स एक प्राधिकरण हेडर का उपयोग करते हैं:

Authorization: Bearer YOUR_API_KEY

यदि आपके पास अभी तक खाता नहीं है, तो आप यहाँ एक बना सकते हैं: पंजीकरण करें.

एंडपॉइंट अवलोकन

इस गाइड में सभी अनुरोधों के लिए आधार पैटर्न: https://zylalabs.com/api/... के साथ Authorization: Bearer YOUR_API_KEY। नीचे NRL API के लिए उपलब्ध एंडपॉइंट्स के साथ सटीक URLs और पैरामीटर दिए गए हैं जिन्हें आप उपयोग कर सकते हैं।

सीढ़ी (GET)

आपके द्वारा चुने गए सीज़न के लिए वर्तमान सीढ़ी के आँकड़े लौटाता है। आप वर्तमान वर्ष या 2002 तक किसी भी सीज़न का उपयोग कर सकते हैं।

विधि: GET
URL: https://zylalabs.com/api/4554/nrl-api/5601/ladder
आवश्यक क्वेरी पैरामीटर:
- सीज़न (संख्या): उदाहरण मान 2025

आधिकारिक कर्ल उदाहरण (कॉपी-पेस्ट के लिए तैयार):

curl -s -X GET "https://zylalabs.com/api/4554/nrl-api/5601/ladder?season=2025" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक नमूना JSON प्रतिक्रिया:

{"status":"success","data":[{"season":"2024","ladder":{"position":"1","team":"Melbourne","played":"24","wins":"19","losses":"5","draws":"-","bye":"3","for":"692","against":"449","ladder_points":"44"}},{"season":"2024","ladder":{"position":"2","team":"Penrith","played":"24","wins":"17","losses":"7","draws":"-","bye":"3","for":"580","against":"394","ladder_points":"40"}},{"season":"2024","ladder":{"position":"3","team":"Sydney","played":"24","wins":"16","losses":"8","draws":"-","bye":"3","for":"738","against":"463","ladder_points":"38"}},{"season":"2024","ladder":{"position":"4","team":"Cronulla","played":"24","wins":"16","losses":"8","draws":"-","bye":"3","for":"653","against":"431","ladder_points":"38"}},{"season":"2024","ladder":{"position":"5","team":"North Qld","played":"24","wins":"15","losses":"9","draws":"-","bye":"3","for":"657","against":"568","ladder_points":"36"}},{"season":"2024","ladder":{"position":"6","team":"Canterbury","played":"24","wins":"14","losses":"10","draws":"-","bye":"3","for":"529","against":"433","ladder_points":"34"}},{"season":"2024","ladder":{"position":"7","team":"Manly","played":"24","wins":"13","losses":"10","draws":"1","bye":"3","for":"634","against":"521","ladder_points":"33"}},{"season":"2024","ladder":{"position":"8","team":"Newcastle","played":"24","wins":"12","losses":"12","draws":"-","bye":"3","for":"470","against":"510","ladder_points":"30"}},{"season":"2024","ladder":{"position":"9","team":"Canberra","played":"24","wins":"12","losses":"12","draws":"-","bye":"3","for":"474","against":"601","ladder_points":"30"}},{"season":"2024","ladder":{"position":"10","team":"Dolphins","played":"24","wins":"11","losses":"13","draws":"-","bye":"3","for":"577","against":"578","ladder_points":"28"}},{"season":"2024","ladder":{"position":"11","team":"St Geo Illa","played":"24","wins":"11","losses":"13","draws":"-","bye":"3","for":"508","against":"634","ladder_points":"28"}},{"season":"2024","ladder":{"position":"12","team":"Brisbane","played":"24","wins":"10","losses":"14","draws":"-","bye":"3","for":"537","against":"607","ladder_points":"26"}},{"season":"2024","ladder":{"position":"13","team":"Warriors","played":"24","wins":"9","losses":"14","draws":"1","bye":"3","for":"512","against":"574","ladder_points":"25"}},{"season":"2024","ladder":{"position":"14","team":"Gold Coast","played":"24","wins":"8","losses":"16","draws":"-","bye":"3","for":"488","against":"656","ladder_points":"22"}},{"season":"2024","ladder":{"position":"15","team…

इसे जल्दी से पढ़ने का तरीका:

status: सफलता को इंगित करने वाला स्ट्रिंग।
data: सीढ़ी प्रविष्टियों का एक एरे। प्रत्येक प्रविष्टि में:
- सीज़न: सीज़न लेबल।
- सीढ़ी: एक ऑब्जेक्ट जिसमें स्थिति, टीम, खेले गए, जीत, हार, ड्रॉ, बाय, फॉर, अगेंस्ट, सीढ़ी_पॉइंट्स जैसे फ़ील्ड होते हैं।

फिक्स्चर (GET)

एक दिए गए सीज़न में एक दिए गए राउंड के लिए फिक्स्चर लौटाता है। इसका उपयोग कार्यक्रम, पिछले राउंड के स्कोर, या भविष्य के राउंड के बारे में जानकारी प्रदर्शित करने के लिए करें।

विधि: GET
URL: https://zylalabs.com/api/4554/nrl-api/5602/fixture
आवश्यक क्वेरी पैरामीटर:
- सीज़न (संख्या): उदाहरण मान 2024
- राउंड (संख्या): उदाहरण मान 1

कर्ल उदाहरण:

प्रतिक्रिया में सीज़न, राउंड लेबल, और मैच_id, दिनांक, समय, टीम नाम, स्कोर/पॉइंट, रेफरी, स्थल, और भीड़ के साथ फिक्स्चर का एक एरे शामिल है। मैच विवरण का अनुरोध करने के लिए match_id मानों का उपयोग करें।

मैच विवरण (GET)

फिक्स्चर एंडपॉइंट से एक मैच_id दिए जाने पर, स्कोरशीट और लाइनअप जैसे विवरण प्राप्त करें।

विधि: GET
URL: https://zylalabs.com/api/4554/nrl-api/5603/match-details
आवश्यक क्वेरी पैरामीटर:
- match_id (संख्या): उदाहरण मान 62004

कर्ल उदाहरण:

प्रतिक्रिया में मैच स्थिति, दिनांक, किक-ऑफ समय, रेफरी, स्थल, भीड़, होम_टीम, अवे_टीम, और एक मैच_details ऑब्जेक्ट (जिसमें नेस्टेड मैच_score, स्कोरशीट, और लाइनअप डेटा शामिल हैं) शामिल हैं।

JavaScript फेच: एंड-टू-एंड सीढ़ी रेंडरिंग

निम्नलिखित JavaScript कोड सीढ़ी एंडपॉइंट को कॉल करता है, कुछ सामान्य फ़ील्ड निकालता है, और एक न्यूनतम स्टैंडिंग एरे लॉग करता है जिसे आप अपने ऐप में रेंडर कर सकते हैं। यह ऊपर दिए गए आधिकारिक कर्ल के समान एंडपॉइंट और पैरामीटर का उपयोग करता है।

// लेबल: JavaScript उदाहरण (सीढ़ी)
async function fetchNrlLadder() {
const url = "https://zylalabs.com/api/4554/nrl-api/5601/ladder?season=2025";

const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});

if (!res.ok) {
const text = await res.text();
throw new Error("NRL API अनुरोध विफल: " + res.status + " - " + text);
}

const json = await res.json();

// अपेक्षित आकार: { status: "success", data: [ { season: "...", ladder: {...} }, ... ] }
const rows = (json.data || []).map(entry => {
const l = entry.ladder || {};
return {
season: entry.season,
position: l.position,
team: l.team,
played: l.played,
wins: l.wins,
losses: l.losses,
draws: l.draws,
for: l.for,
against: l.against,
points: l.ladder_points
};
});

console.table(rows.slice(0, 8)); // शीर्ष 8 की त्वरित सत्यापन जांच
}

fetchNrlLadder().catch(console.error);

नोट्स:

अपनी API कुंजी को सर्वर-साइड कोड या एक वातावरण चर में रखें। यदि आपको ब्राउज़र से कॉल करना है, तो अपने बैकएंड के माध्यम से अनुरोध को प्रॉक्सी करें।
कॉल्स को कम करने के लिए सीज़न के अनुसार सीढ़ी प्रतिक्रियाओं को कैश करें; सीढ़ी राउंड पूरा होने के बाद बदलती है न कि मिनट-दर-मिनट।

व्यावहारिक एकीकरण पैटर्न

1) साप्ताहिक स्टैंडिंग विजेट

प्रत्येक राउंड के बाद एक बार सीढ़ी एंडपॉइंट को कॉल करें। प्रतिक्रिया को बनाए रखें ताकि आपका फ्रंटेंड तुरंत नवीनतम तालिका को रेंडर कर सके। प्रदर्शित फ़ील्ड: स्थिति, टीम, खेले गए, जीत, हार, फॉर, अगेंस्ट, सीढ़ी_पॉइंट्स।

2) राउंड-बाय-राउंड शेड्यूल पृष्ठ

चुने गए सीज़न और राउंड के लिए फिक्स्चर एंडपॉइंट का उपयोग करें। दिनांक, समय, होम_टीम, अवे_टीम, स्थल, और भीड़ को रेंडर करें। जहां उपलब्ध हो, पूर्ण मैचों के लिए होम_स्कोर या अवे_पॉइंट दिखाएं। प्रत्येक पंक्ति को मैच विवरण पृष्ठ से लिंक करें जिसका उपयोग match_id करें।

3) मैच केंद्र

मैच विवरण पृष्ठ पर, फिक्स्चर से match_id के साथ मैच विवरण प्राप्त करें। मैच_status, किक_off, रेफरी, और स्थल प्रदर्शित करें। मैच_score फ़ील्ड (होम_स्कोर, अवे_स्कोर, हाफटाइम विभाजन) और लाइनअप दिखाएं।

4) न्यूनतम कैशिंग रणनीति

सीढ़ी: सीज़न के अनुसार कैश करें; राउंड पूरा होने के अनुसार एक शेड्यूल पर ताज़ा करें।
फिक्स्चर: सीज़न+राउंड के अनुसार कैश करें; यदि आप मैचों के पूरा होने पर स्कोर में बदलाव का पता लगाते हैं तो ताज़ा करें।
मैच विवरण: मैच_id के अनुसार कैश करें जिसमें एक छोटे TTL के साथ खेल चल रहा है, फिर पूरा होने पर अंतिम रूप से स्टोर करें।

कॉपी-पेस्ट cURL उदाहरण

आप इन सटीक अनुरोधों के साथ अपने सेटअप को जल्दी से सत्यापित कर सकते हैं (इनमें प्राधिकरण हेडर और आपकी कुंजी की आवश्यकता होती है)। ये URLs Zyla API Hub पर NRL API लिस्टिंग से हैं।

सीढ़ी

फिक्स्चर (सीज़न + राउंड)

मैच विवरण (match_id द्वारा)

AI एजेंटों द्वारा MCP के माध्यम से NRL API को कॉल करना

Zyla API Hub पर हर API को MCP एंडपॉइंट के माध्यम से AI एजेंटों से कॉल किया जा सकता है: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY। यह क्लॉड कोड, कर्सर, और विंडसर्फ जैसे MCP-संगत क्लाइंट के साथ काम करता है। आपका एजेंट ऊपर दिखाए गए समान NRL API URLs का अनुरोध कर सकता है; MCP परत आपके Zyla API Hub क्रेडेंशियल्स का उपयोग करके अनुरोधों को अग्रेषित करती है।

MCP उपयोग के बारे में अधिक जानकारी के लिए देखें: MCP.

गोटचास और विश्वसनीयता टिप्स

प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY भेजें।
पैरामीटर: प्रत्येक एंडपॉइंट के लिए केवल प्रलेखित पैरामीटर (सीज़न, राउंड, match_id) पास करें। इन GET अनुरोधों पर शरीर न भेजें।
त्रुटि हैंडलिंग: गैर-2xx प्रतिक्रियाओं को त्रुटियों के रूप में मानें और निदान के लिए शरीर को लॉग करें।
डेटा ताजगी: सीढ़ी सीज़न के साथ अपडेट होती है; फिक्स्चर पिछले स्कोर और भविष्य की अनुसूची दोनों प्रदान करते हैं। मैच विवरण में मैचों के पूरा होने पर ग्रैन्युलर फ़ील्ड शामिल होते हैं।
कोटा: Zyla सदस्यता + कोटा का उपयोग करता है। एक नए खाते पर पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोधों को शामिल करता है। अपने उपयोग की निगरानी करें और वर्तमान पहुंच विकल्पों के लिए API पृष्ठ की जांच करें।

कहाँ अन्वेषण करें और अगले कदम

Zyla पर NRL API लिस्टिंग ब्राउज़ करें: NRL API. Zyla 10,000 से अधिक सार्वजनिक APIs को केंद्रीकृत करता है, इसलिए आप बाद में बिना नए खातों या कई कुंजियों को संभाले अतिरिक्त खेल डेटा जोड़ सकते हैं।

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

प्रश्न: NRL API को कौन सा ऑथ हेडर चाहिए?
उत्तर: Zyla API Hub URLs पर हर अनुरोध पर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

प्रश्न: प्रत्येक एंडपॉइंट के लिए कौन से पैरामीटर आवश्यक हैं?
उत्तर: सीढ़ी के लिए सीज़न आवश्यक है। फिक्स्चर के लिए सीज़न और राउंड आवश्यक हैं। मैच विवरण के लिए match_id आवश्यक है। केवल उन प्रलेखित क्वेरी पैरामीटर को पास करें।

प्रश्न: क्या मैं ऐतिहासिक सीज़न प्राप्त कर सकता हूँ?
उत्तर: हाँ। सीढ़ी और फिक्स्चर एंडपॉइंट 2002 तक के सीज़नों का समर्थन करते हैं, वर्तमान वर्ष के अलावा।

प्रश्न: क्या कोई मुफ्त योजना है?
उत्तर: कोई मुफ्त योजना नहीं है। नए Zyla खाते पर पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोधों को शामिल करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

प्रश्न: क्या मैं AI एजेंट से API को कॉल कर सकता हूँ?
उत्तर: हाँ। https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर MCP एंडपॉइंट का उपयोग करें। आपका एजेंट फिर वही NRL API URLs कॉल कर सकता है।

शिप करने के लिए तैयार? अपना खाता बनाएं, NRL API की सदस्यता लें, और अपनी कुंजी यहाँ प्राप्त करें: पंजीकरण करें. फिर ऊपर दिए गए कर्ल और JavaScript स्निपेट को अपने ऐप में प्लग करें और इस सप्ताह अपने NRL सीढ़ी, फिक्स्चर, और मैच केंद्र को तैनात करें।