您需要在本周发布一个NRL积分榜和赛程小部件。在本指南结束时，您将使用JavaScript fetch从Zyla API Hub查询NRL API，渲染一个赛季的当前积分榜，提取给定轮次的赛程，并深入了解特定比赛的详细信息——准备好放入您的应用或仪表板中。
您在Zyla API Hub上获得的NRL API
NRL API提供了结构化的橄榄球联赛数据，您可以直接从前端或后端使用：
- 积分榜：您选择的赛季的当前积分（支持当前年份和2002年之前的年份）。
- 赛程：您选择的轮次的比赛安排和得分（当前赛季和2002年之前的年份）。
- 比赛详情：来自赛程端点的比赛ID的深入信息，包括得分和阵容。
它在Zyla API Hub市场上列出，该市场在一个帐户下聚合了超过10,000个公共API，一个API密钥和订阅模型。您可以在这里浏览NRL API列表： NRL API。
在Zyla API Hub上开始
设置只需几分钟：
- 在Zyla API Hub上打开 NRL API页面。
- 点击订阅。计划使用订阅 + 配额（不是按调用计费）。新帐户上的第一个API通常包括7天的试用或50个请求。没有免费计划。请查看API页面以获取当前访问选项和定价。
- 复制您的API密钥。
所有调用都使用Authorization头：
- Authorization: Bearer YOUR_API_KEY
如果您还没有帐户，可以在这里创建一个： 注册。
端点概述
本指南中所有请求的基本模式：https://zylalabs.com/api/...，带有Authorization: Bearer YOUR_API_KEY。以下是NRL API可用的端点以及您可以使用的确切URL和参数。
积分榜（GET）
返回您选择的赛季的当前积分榜统计信息。您可以使用当前年份或任何2002年之前的赛季。
- 方法：GET
- URL：https://zylalabs.com/api/4554/nrl-api/5601/ladder
- 所需查询参数：
- season（数字）：示例值2025
官方curl示例（可复制粘贴）：
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：积分条目的数组。每个条目都有：
- season：赛季标签。
- ladder：一个包含位置、团队、比赛、胜利、失败、平局、轮空、得分、失分、积分的字段的对象。
赛程（GET）
返回给定赛季中给定轮次的赛程。使用它来显示赛程、之前轮次的得分或未来轮次的信息。
- 方法：GET
- URL：https://zylalabs.com/api/4554/nrl-api/5602/fixture
- 所需查询参数：
- season（数字）：示例值2024
- round（数字）：示例值1
curl示例：
响应包括赛季、轮次标签和一个包含比赛ID、日期、时间、球队名称、得分/积分、裁判、场馆和观众的赛程数组。使用match_id值请求比赛详情。
比赛详情（GET）
根据来自赛程端点的match_id，检索得分表和阵容等详细信息。
- 方法：GET
- URL：https://zylalabs.com/api/4554/nrl-api/5603/match-details
- 所需查询参数：
- match_id（数字）：示例值62004
curl示例：
响应包括比赛状态、日期、开球时间、裁判、场馆、观众、主队、客队和一个比赛详情对象（包含嵌套的比赛得分、得分表和阵容数据）。
JavaScript fetch：端到端积分榜渲染
以下JavaScript代码调用积分榜端点，提取一些常见字段，并记录一个最小的积分数组，您可以在应用中渲染。它使用与上面的官方curl相同的端点和参数。
// 标签：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获取比赛详情。显示比赛状态、开球时间、裁判和场馆。显示比赛得分字段（主队得分、客队得分、半场分数）和阵容。
4）最小缓存策略
- 积分榜：按赛季缓存；在与轮次完成对齐的时间表上刷新。
- 赛程：按赛季+轮次缓存；如果您检测到比赛完成时得分发生变化，则刷新。
- 比赛详情：按match_id缓存，比赛进行时TTL短暂，完成后存储为最终状态。
复制粘贴cURL示例
您可以使用这些确切请求快速验证您的设置（它们需要Authorization头和您的密钥）。这些URL来自Zyla API Hub上的NRL API列表。
积分榜
赛程（赛季 + 轮次）
比赛详情（按match_id）
通过MCP从AI代理调用NRL API
在Zyla API Hub上的每个API都可以通过MCP端点调用：https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY。它与MCP兼容的客户端（如Claude Code、Cursor和Windsurf）一起使用。您的代理可以请求上面显示的相同NRL API URL；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个公共API，因此您可以在以后添加其他体育数据，而无需创建新帐户或处理多个密钥。
常见问题
问：NRL API需要什么身份验证头？
答：在每个请求中使用Authorization: Bearer YOUR_API_KEY访问Zyla API Hub URL。
问：每个端点需要哪些参数？
答：积分榜需要赛季。赛程需要赛季和轮次。比赛详情需要match_id。仅传递那些文档中的查询参数。
问：我可以获取历史赛季吗？
答：可以。积分榜和赛程端点支持从2002年开始的赛季，此外还有当前年份。
问：是否有免费计划？
答：没有免费计划。新Zyla帐户上的第一个API通常包括7天的试用或50个请求。请查看API页面以获取当前访问选项和定价。
问：我可以从AI代理调用API吗？
答：可以。使用MCP端点https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY。然后，您的代理可以调用相同的NRL API URL。
准备好发布了吗？在这里创建您的帐户，订阅NRL API并获取您的密钥： 注册。然后将上面的curl和JavaScript代码片段插入您的应用中，并在本周发布您的NRL积分榜、赛程和比赛中心。
