आपको इस सप्ताह C# में NRL स्टैंडिंग और फिक्स्चर एकीकरण भेजने की आवश्यकता है। इस गाइड के अंत तक, आप Zyla API Hub पर NRL डेटा API से लाइव सीढ़ी स्टैंडिंग, राउंड फिक्स्चर और मैच विवरणों को क्वेरी करेंगे और उन्हें HttpClient का उपयोग करके अपने ऐप में प्रदर्शित करेंगे—इसके अलावा यह भी देखेंगे कि JavaScript और AI एजेंटों से MCP के माध्यम से समान एंडपॉइंट्स को कैसे हिट करें।
NRL डेटा API के साथ आप क्या बना सकते हैं
NRL डेटा API वर्तमान और ऐतिहासिक प्रतियोगिता डेटा (2002 से) प्रदान करता है:
- सीढ़ी: जीत, हार, अंक के लिए/खिलाफ, आदि के साथ सीजन स्टैंडिंग।
- फिक्स्चर: दिए गए राउंड और सीजन के लिए मैच, जिसमें स्कोर और स्थल शामिल हैं।
- मैच विवरण: एक विशिष्ट मैच ID के लिए गहन डेटा, जिसमें स्कोरशीट और लाइनअप शामिल हैं।
डेवलपर्स आमतौर पर इस API का उपयोग स्कोरबोर्ड, स्टैंडिंग पृष्ठ, मैच केंद्र, सूचनाएं और खेल उत्पादों के लिए विश्लेषण को शक्ति देने के लिए करते हैं। चूंकि ये एंडपॉइंट्स Zyla API Hub पर होस्ट किए गए हैं, आप उसी तरह प्रमाणीकरण करते हैं जैसे आप मार्केटप्लेस पर हजारों अन्य APIs के साथ करते हैं—एक खाता, एक API कुंजी, सब्सक्रिप्शन + कोटा बिलिंग (पे-पर-कॉल नहीं)। पहला API 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
लिस्टिंग का अन्वेषण करें: NRL डेटा API। Zyla API Hub पर 10,000 से अधिक सार्वजनिक APIs ब्राउज़ करें।
Zyla API Hub पर शुरुआत करना
- Zyla API Hub पर NRL डेटा API पृष्ठ खोलें।
- सब्सक्राइब या फ्री ट्रायल शुरू करने के लिए क्लिक करें (जब उपलब्ध हो)। प्लेटफ़ॉर्म एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। पहला API 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; कोई मुफ्त योजना नहीं है।
- अपने डैशबोर्ड से अपनी API कुंजी प्राप्त करें। सभी अनुरोध हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करते हैं।
यदि आपके पास अभी तक खाता नहीं है, तो आप पंजीकरण करें एक मुफ्त खाता बनाने और API कुंजी प्राप्त करने के लिए।
एंडपॉइंट्स का अवलोकन
बेस कॉलिंग पैटर्न: नीचे दिए गए सटीक हब URLs का उपयोग करें और Authorization हेडर का उपयोग करें। अतिरिक्त पैरामीटर न जोड़ें।
1) सीढ़ी (GET)
एक विशिष्ट सीजन के लिए सीढ़ी के आँकड़े प्राप्त करें (वर्तमान वर्ष और 2002 से ऐतिहासिक डेटा का समर्थन करता है)।
- विधि: GET
- URL: https://zylalabs.com/api/4535/nrl-data-api/5576/ladder
- आवश्यक क्वेरी पैरामीटर:
- सीजन (संख्या): 2025
आधिकारिक curl नमूना:
curl -s -X GET "https://zylalabs.com/api/4535/nrl-data-api/5576/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: "success" एक सफल कॉल को इंगित करता है।
- data: एक एरे जिसमें उस सीजन के लिए सीढ़ी पंक्तियाँ शामिल हैं जिसे आपने अनुरोध किया था।
- प्रत्येक आइटम में:
- season: एक स्ट्रिंग के रूप में सीजन लेबल।
- ladder: एक ऑब्जेक्ट जिसमें position, team, played, wins, losses, draws, bye, for, against, और ladder_points स्ट्रिंग के रूप में शामिल हैं।
2) फिक्स्चर (GET)
एक सीजन और राउंड के लिए फिक्स्चर (और जब उपलब्ध हो तो स्कोर) प्राप्त करें।
- विधि: GET
- URL: https://zylalabs.com/api/4535/nrl-data-api/5577/fixture
- आवश्यक क्वेरी पैरामीटर:
- सीजन (संख्या): 2026
- राउंड (संख्या): 7
आधिकारिक curl नमूना:
यह एंडपॉइंट चुने गए राउंड के लिए फिक्स्चर लौटाता है, जिसमें match_id, date, time, home_team, home_score, away_team, away_points, referee, venue, और crowd जैसे फ़ील्ड शामिल हैं (प्रदान किए गए उदाहरण के आधार पर)। इस प्रतिक्रिया से match_id का उपयोग करके विस्तृत मैच डेटा क्वेरी करें।
3) मैच विवरण (GET)
फिक्स्चर एंडपॉइंट से match_id का उपयोग करके एक विशिष्ट मैच का विवरण (स्कोर, लाइनअप, और अधिक) प्राप्त करें।
- विधि: GET
- URL: https://zylalabs.com/api/4535/nrl-data-api/5578/match-details
- आवश्यक क्वेरी पैरामीटर:
- match_id (संख्या): 5732
आधिकारिक curl नमूना:
यह एंडपॉइंट एक संरचना लौटाता है जिसमें match_id, match_status, date, kick_off, referee, venue, crowd, home_team, away_team, और nested match_details (जैसे match_score और scoresheet) और lineups जैसे कुंजी शामिल हैं (प्रदान किए गए उदाहरण के आधार पर)।
C# HttpClient: सीढ़ी एंडपॉइंट को कॉल करें और स्टैंडिंग को पार्स करें
नीचे दिया गया स्निपेट HttpClient का उपयोग करके दिए गए सीजन के लिए वर्तमान सीढ़ी का अनुरोध करता है, फिर टीम, स्थिति, और सीढ़ी अंक प्रदर्शित करने के लिए एक सरल मॉडल प्रक्षिप्त करता है। एकमात्र आवश्यक पैरामीटर सीजन है, और प्रमाणीकरण एक Bearer टोकन है।
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;
public class NrlLadderRow
{
[JsonPropertyName("season")]
public string Season { get; set; }
[JsonPropertyName("ladder")]
public LadderStats Ladder { get; set; }
}
public class LadderStats
{
[JsonPropertyName("position")]
public string Position { get; set; }
[JsonPropertyName("team")]
public string Team { get; set; }
[JsonPropertyName("played")]
public string Played { get; set; }
[JsonPropertyName("wins")]
public string Wins { get; set; }
[JsonPropertyName("losses")]
public string Losses { get; set; }
[JsonPropertyName("draws")]
public string Draws { get; set; }
[JsonPropertyName("bye")]
public string Bye { get; set; }
[JsonPropertyName("for")]
public string ForPoints { get; set; }
[JsonPropertyName("against")]
public string AgainstPoints { get; set; }
[JsonPropertyName("ladder_points")]
public string LadderPoints { get; set; }
}
public class LadderResponse
{
[JsonPropertyName("status")]
public string Status { get; set; }
[JsonPropertyName("data")]
public List<NrlLadderRow> Data { get; set; }
}
public class Program
{
private static async Task Main()
{
var apiKey = "YOUR_API_KEY";
var season = 2025; // required query param
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
var url = $"https://zylalabs.com/api/4535/nrl-data-api/5576/ladder?season={season}";
using var res = await http.GetAsync(url);
res.EnsureSuccessStatusCode();
var json = await res.Content.ReadAsStringAsync();
var opts = new JsonSerializerOptions
{
PropertyNameCaseInsensitive = true
};
var model = JsonSerializer.Deserialize<LadderResponse>(json, opts);
if (model?.Status != "success" || model.Data == null)
{
Console.Error.WriteLine("Unexpected API response.");
return;
}
// Print top 5
foreach (var row in model.Data)
{
if (int.TryParse(row.Ladder.Position, out var pos) && pos > 5) break;
Console.WriteLine($"#{row.Ladder.Position} {row.Ladder.Team} - Pts: {row.Ladder.LadderPoints} (W{row.Ladder.Wins}-L{row.Ladder.Losses})");
}
}
}नोट्स:
- सभी सीढ़ी फ़ील्ड नमूने में स्ट्रिंग हैं। केवल उन स्थानों पर पूर्णांक में परिवर्तित करें जहाँ आपको मानों की गणना करने की आवश्यकता है।
- हमेशा जांचें कि स्थिति "success" के बराबर है। लॉगिंग और बैकिंग ऑफ़ द्वारा गैर-सफल प्रतिक्रियाओं को संभालें।
- सर्वर-साइड ऐप्स के लिए जो स्टैंडिंग को कम बार ताज़ा करते हैं, एक सीजन के लिए प्रतिक्रिया को कैश करें ताकि पुनरावृत्त कॉल से बचा जा सके।
JavaScript उदाहरण: सीढ़ी को लाएं और प्रमुख फ़ील्ड पढ़ें
यह JavaScript स्निपेट उसी सीढ़ी कॉल को दोहराता है। यह सटीक हब URL और आवश्यक सीजन पैरामीटर का उपयोग करता है।
async function fetchNrlLadder(season = 2025) {
const res = await fetch(`https://zylalabs.com/api/4535/nrl-data-api/5576/ladder?season=${season}`, {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
if (!res.ok) {
throw new Error(`HTTP ${res.status}`);
}
const data = await res.json();
if (data.status !== "success" || !Array.isArray(data.data)) {
throw new Error("Unexpected API response format");
}
// Example: map to minimal objects
const topRows = data.data.slice(0, 5).map(r => ({
team: r.ladder.team,
position: r.ladder.position,
points: r.ladder.ladder_points,
wins: r.ladder.wins,
losses: r.ladder.losses
}));
return topRows;
}
fetchNrlLadder().then(rows => {
console.table(rows);
}).catch(err => {
console.error(err);
});व्यावहारिक उपयोग पैटर्न
- स्टैंडिंग पृष्ठ: प्रत्येक डिप्लॉय पर या दैनिक एक बार सीढ़ी को कॉल करें (आपके उपयोग के मामले के आधार पर)। सीजन पैरामीटर 2002 से ऐतिहासिक डेटा का समर्थन करता है।
- राउंड केंद्र: स्कोर और स्थलों के साथ एक शेड्यूल बनाने के लिए सीजन और राउंड के साथ फिक्स्चर को कॉल करें। समर्पित मैच पृष्ठों को हाइड्रेट करने के लिए match_id मानों को स्टोर करें।
- मैच पृष्ठ: स्कोरशीट और लाइनअप के लिए match_id द्वारा मैच विवरण लाएं। उदाहरण में match_details.match_score और लाइनअप जैसे नेस्टेड ऑब्जेक्ट दिखाए गए हैं।
- समय क्षेत्र और प्रदर्शन: दिनांक/समय फ़ील्ड स्ट्रिंग के रूप में आते हैं (उदाहरण के लिए, "2024-03-02" और "6:30pm")। प्रदर्शन के लिए उन्हें स्ट्रिंग के रूप में रखें या यदि आपके पास ज्ञात स्थानीय संदर्भ हैं तो उन्हें अपने ऐप में सामान्यीकृत करें।
- कैशिंग: स्थिर डेटा (पिछले सीज़न या पूर्ण राउंड) के लिए, आक्रामक रूप से कैश करें। प्रगति में राउंड के लिए, एक छोटे TTL के लिए कैश करें और अपने उत्पाद में मैच शुरू/समाप्त घटनाओं पर अमान्य करें।
AI एजेंटों के माध्यम से MCP से NRL डेटा API को कॉल करना
आप Zyla MCP एंडपॉइंट का उपयोग करके AI कोडिंग एजेंटों से समान HTTP कॉल ट्रिगर कर सकते हैं। कोई भी MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) आपकी कुंजी के साथ आपके सब्सक्राइब किए गए APIs तक पहुंच सकता है:
- MCP एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
- उपरोक्त दिखाए गए सटीक हब URLs और आवश्यक पैरामीटर का उपयोग करें। प्रमाणीकरण अभी भी Authorization: Bearer YOUR_API_KEY है।
- क्लाइंट सेटअप और विवरण के लिए, MCP दस्तावेज़ देखें।
त्रुटि हैंडलिंग, सीमाएँ, और संचालन टिप्स
- प्रमाणीकरण: प्रत्येक अनुरोध में Authorization: Bearer YOUR_API_KEY शामिल होना चाहिए।
- पैरामीटर: केवल प्रत्येक एंडपॉइंट के लिए दिखाए गए आवश्यक पैरामीटर भेजें। बॉडी पेलोड न जोड़ें; ये एंडपॉइंट सरल GET अनुरोध हैं।
- कोटा: Zyla APIs सब्सक्रिप्शन + कोटा बिलिंग का उपयोग करते हैं (पे-पर-कॉल नहीं)। पहला API 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; कोई मुफ्त योजना नहीं है। अपने Zyla डैशबोर्ड में अपने उपयोग की निगरानी करें।
- लचीलापन: HTTP त्रुटियों पर, URL और स्थिति कोड लॉग करें, फिर बैकऑफ के साथ पुनः प्रयास करें। 4xx त्रुटियों पर गर्म लूप से बचें—ये आमतौर पर गायब/अमान्य पैरामीटर या प्रमाणीकरण को इंगित करते हैं।
- स्कीमा परिवर्तन: पार्सर्स को डिज़ाइन करें जो अतिरिक्त फ़ील्ड को सहन करते हैं। केवल इस गाइड में दिखाए गए कुंजी या आपके रनटाइम निरीक्षण पर भरोसा करें।
लिंक पुनर्कथन
- NRL डेटा API लिस्टिंग: Zyla पर देखें
- 10,000 से अधिक सार्वजनिक APIs का अन्वेषण करें: Zyla API Hub
अक्सर पूछे जाने वाले प्रश्न
प्रश्न: मैं प्रमाणीकरण के लिए कौन सा हेडर उपयोग करूं?
उत्तर: प्रत्येक अनुरोध पर Authorization: Bearer YOUR_API_KEY।
प्रश्न: कौन से सीज़न समर्थित हैं?
उत्तर: API वर्तमान सीज़न और 2002 से ऐतिहासिक डेटा का समर्थन करता है (एंडपॉइंट विवरण के अनुसार)।
प्रश्न: मैं मैच विवरण के लिए match_id कैसे प्राप्त करूं?
उत्तर: सीजन और राउंड के साथ फिक्स्चर एंडपॉइंट को कॉल करें। फिक्स्चर एरे से match_id पढ़ें और इसे मैच विवरण एंडपॉइंट पर पास करें।
प्रश्न: क्या कोई मुफ्त योजना है?
उत्तर: कोई मुफ्त योजना नहीं है। पहला API 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
प्रश्न: क्या मैं इन APIs को AI एजेंटों से कॉल कर सकता हूं?
उत्तर: हाँ। अपने सब्सक्राइब किए गए API के हब URLs और समान Authorization हेडर के साथ https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर MCP एंडपॉइंट का उपयोग करें।
एकीकृत करने के लिए तैयार हैं? Zyla पर एक खाता बनाएं, NRL डेटा API की सदस्यता लें, और मार्केटप्लेस में एकल कुंजी के साथ शिपिंग शुरू करें। अब पंजीकरण करें और हजारों उत्पादन-तैयार APIs का अन्वेषण करें।
