您本周正在尝试发布NRL赛程视图，并需要可靠的逐轮比赛、开球时间、场馆和得分——以及一个用于排名的梯子。在本指南结束时，您将调用一个真实的端点，该端点返回给定赛季和轮次的NRL赛程，解析代码，并了解如何使用相同的API密钥获取梯子和详细的比赛数据。
该API返回的内容及其用途
Zyla API Hub上的橄榄球实时数据API公开了您可以快速集成到产品中的结构化NRL数据：
- NRL赛程：给定赛季和轮次的比赛，包括球队、开球时间、场馆和得分。
- NRL梯子：每支球队的主场、客场和整体记录的排名。
- 比赛数据（橄榄球联合会）：详细得分、裁判、阵容、统计数据和事件，包括响应架构中描述的UTC的ISO 8061时间戳。
构建记分板、博彩工具、广播伴侣应用程序和分析仪表板的团队可以使用这些端点，使用一个API密钥和一致的身份验证模式。
如果您还在浏览其他类别，Zyla API Hub市场汇聚了超过10,000个公共API，您只需一个订阅和密钥，因此可以保持您的集成面小。
在Zyla API Hub上开始
打开橄榄球实时数据API页面，点击订阅（或在可用时开始免费试用），并获取您的API密钥。身份验证是一个HTTP头：
- 头：Authorization: Bearer YOUR_API_KEY
计费是订阅+配额（不是按调用计费）。对于第一次集成，您通常会有7天的试用期或50个请求来验证您的构建。没有免费计划——请查看API页面以获取当前访问选项和定价。您可以随时从Zyla API Hub目录中探索其他体育数据集，使用相同的帐户。
NRL赛程：赛季和轮次
NRL赛程端点返回特定轮次的所有比赛，包括球队、开球信息、场馆和可用的最终得分。赛季可以追溯到2002年。
- 方法：GET
- URL：https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture
- 所需参数：
- season（数字）：2024
- round（数字）：16
cURL示例
curl -s -X GET "https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions" \
-H "Authorization: Bearer YOUR_API_KEY"真实响应（截断为官方示例）
{
"meta": {
"title": "橄榄球实时数据API - 竞争列表",
"description": "当前活跃的橄榄球比赛列表。",
"fields": {
"id": "整数 - 用于查询其他端点",
"name": "字符串 - 竞争名称",
"season": "整数 - 用于查询其他端点",
"season_name": "字符串 - 赛季的文本表示"
}
},
"results": [
{
"id": 30,
"name": "国际",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1218,
"name": "Gallagher Prem",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1230,
"name": "TOP 14",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1236,
"name": "联合橄榄球锦标赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1260,
"name": "Bunnings Warehouse NPC",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1266,
"name": "六国赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1278,
"name": "Pro D2",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1446,
"name": "Heartland Championship",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1464,
"name": "Investec Champions Cup",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1470,
"name": "EPCR挑战杯",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1500,
"name": "女子六国赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1962,
"name": "Top 14接入比赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1968,
"name": "Prem Rugby Cup",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1980,
"name":…您在应用中实际使用的内容：
- data.season和data.round：用于标记轮次视图。
- fixtures[].home_team，fixtures[].away_team，fixtures[].time，fixtures[].venue：用于渲染比赛卡片。
- fixtures[].home_score和fixtures[].away_score：用于已完成的比赛。
- fixtures[].match_id：用于构建指向您内部比赛页面的深度链接。
Python示例：渲染轮次时间表
import requests
API_KEY = "YOUR_API_KEY"
URL = "https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture"
params = {
"season": 2024,
"round": 16
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(URL, params=params, headers=headers, timeout=20)
resp.raise_for_status()
payload = resp.json()
if payload.get("status") != "success":
raise RuntimeError("API未返回成功")
data = payload.get("data", {})
fixtures = data.get("fixtures", [])
for f in fixtures:
home = f.get("home_team")
away = f.get("away_team")
when = f.get("time")
date = f.get("date")
venue = f.get("venue")
hs = f.get("home_score")
as_ = f.get("away_score")
score = f"{hs}-{as_}" if hs and as_ else "待定"
print(f"{date} {when} | {home} vs {away} @ {venue} | {score}")NRL梯子：球队排名和记录
NRL梯子端点返回一个赛季的排名，按球队细分（主场、客场、整体）。赛季可以追溯到2002年。
- 方法：GET
- URL：https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder
- 所需参数：
- season（数字）：2024
cURL示例
真实响应（截断为官方示例）
排名屏幕的关键字段：
- ladder.position和ladder.team：用于排序和标记行。
- overall.wins，overall.losses，overall.ladder_points：用于计算UI中的排名逻辑。
- 主客场记录：用于添加分割或过滤视图。
比赛详情（橄榄球联合会）：得分、阵容、事件
如果您还涵盖橄榄球联合会，比赛数据端点返回深入的比赛信息：得分、裁判、阵容、统计数据和事件。这对于详细的盒子得分和逐步播放非常有用。
- 方法：GET
- URL：https://zylalabs.com/api/796/rugby-live-data-api/538/get-match-data
- 参数：此处未记录任何参数。仅使用身份验证调用。
cURL示例
响应（官方示例的架构摘录）
请注意时间戳指导：UTC中的ISO 8061，这简化了跨时区的服务器端规范化。
官方示例：列出支持的比赛
使用此功能来清点API覆盖的比赛。响应显示您可以在其他端点中使用的ID和赛季（如适用）。
{
"meta": {
"title": "Rugby Live Data API - Competition List",
"description": "List of currently active rugby competitions.",
"fields": {
"id": "Integer - use to query other endpoints",
"name": "String - competition name",
"season": "Integer - use to query other endpoints",
"season_name": "String - textual representation of season"
}
},
"results": [
{
"id": 30,
"name": "International",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1218,
"name": "Gallagher Prem",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1230,
"name": "TOP 14",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1236,
"name": "United Rugby Championship",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1260,
"name": "Bunnings Warehouse NPC",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1266,
"name": "Six Nations",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1278,
"name": "Pro D2",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1446,
"name": "Heartland Championship",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1464,
"name": "Investec Champions Cup",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1470,
"name": "EPCR Challenge Cup",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1500,
"name": "Women's Six Nations",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1962,
"name": "Top 14 Access Match",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1968,
"name": "Prem Rugby Cup",
"season": 2027,
"season_name": "Season 2027"
},
{
"id": 1980,
"name":…实际实施注意事项
- 身份验证：始终发送Authorization: Bearer YOUR_API_KEY。
- 请求形状：此处记录的NRL端点接受指定的赛季和轮次。请勿添加未列出的参数。
- 缓存：比赛和梯子在一轮内是稳定的；保守的缓存（例如，每轮）可以减少波动。对于实时场景，请根据您的刷新策略调整TTL。
- 时间戳：在比赛数据架构中，时间戳为ISO 8061，并始终为UTC，如响应字段中所记录。
- 配额：订阅+配额；首次使用时，您通常会获得7天的试用期或50个请求。请在Hub仪表板中监控您的使用情况。
通过MCP从AI代理调用
您可以通过MCP兼容工具（例如Claude Code、Cursor、Windsurf）使用Zyla的MCP端点调用这些端点。提供您的API密钥，让代理协调调用：
- MCP端点：MCP
- API密钥：将其传递给MCP客户端，以便它可以在请求Zyla API Hub端点时发送Authorization: Bearer YOUR_API_KEY。
这对于在您的开发环境中原型化工作流（例如“获取NRL第16轮赛程并总结结果”）非常有帮助。
您本周可以发布的实际用例
- 轮次中心：渲染NRL轮次赛程网格，带有球队徽标和开球线。使用match_id链接到您的详细视图。
- 排名面板：显示带有主客场分割和梯子点的梯子，可按points_difference排序。
- 结果滚动条：轮询赛程端点，以在轮次内提供最终得分。
- 赛前预览：将赛程球队名称和场馆与您的编辑内容或赔率源结合起来。
故障排除提示
- 未授权：确认Authorization头存在且格式正确。
- 空赛程：确保您传递的赛季和轮次值完全为数字。
- 数据规范化：得分字段在示例中为字符串；根据需要在您的领域模型中转换为整数。
常见问题
NRL数据覆盖哪些赛季？
NRL赛程和NRL梯子端点返回的赛季可以追溯到2002年。
赛程中的比赛时间是哪个时区？
赛程示例将日期和时间显示为字符串。详细的橄榄球联合会比赛源记录了UTC中的ISO 8061时间戳；对于NRL赛程，请按照端点提供的格式处理字符串。
我需要为比赛数据端点提供查询参数吗？
本指南中未记录Get Match Data的参数。您可以仅使用身份验证调用，如所示。
计费是如何处理的？
订阅+配额。没有免费计划。首次使用时，预计有7天的试用期或50个请求；请查看API页面以获取当前访问选项和定价。
我可以通过AI编码代理驱动这个吗？
是的。使用Zyla MCP端点并提供您的API密钥，以便代理可以对Hub端点执行经过身份验证的调用。
准备将NRL赛程和梯子集成到您的应用中吗？创建您的帐户，获取API密钥，并在此处开始您的7天试用：开始7天的橄榄球实时数据API试用。
官方API响应
{
"meta": {
"title": "橄榄球实时数据API - 竞争列表",
"description": "当前活跃的橄榄球比赛列表。",
"fields": {
"id": "整数 - 用于查询其他端点",
"name": "字符串 - 竞争名称",
"season": "整数 - 用于查询其他端点",
"season_name": "字符串 - 赛季的文本表示"
}
},
"results": [
{
"id": 30,
"name": "国际",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1218,
"name": "Gallagher Prem",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1230,
"name": "TOP 14",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1236,
"name": "联合橄榄球锦标赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1260,
"name": "Bunnings Warehouse NPC",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1266,
"name": "六国赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1278,
"name": "Pro D2",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1446,
"name": "Heartland Championship",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1464,
"name": "Investec Champions Cup",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1470,
"name": "EPCR挑战杯",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1500,
"name": "女子六国赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1962,
"name": "Top 14接入比赛",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1968,
"name": "Prem Rugby Cup",
"season": 2027,
"season_name": "2027赛季"
},
{
"id": 1980,
"name":…
