您需要一个API来列出哪些橄榄球比赛是支持的，以便您的应用程序可以呈现下拉菜单，验证用户选择，或为后续查询引导ID。到本文结束时，您将调用一个真实的端点，该端点返回活动比赛，解析其字段，并查看如何将其与比赛安排、积分榜和比赛数据结合起来——所有这些都来自Zyla API Hub的同一列表。
您获得的内容：支持的比赛、比赛安排、积分榜和比赛详情
Zyla API Hub上的橄榄球实时数据API公开了端点，以发现活动比赛，获取NRL轮次比赛安排，检索一个赛季的NRL积分榜，并获取详细的橄榄球联合会比赛数据。典型的用法包括：
- 使用官方支持比赛列表（ID和赛季）填充“比赛”选择器。
- 使用每轮的比赛安排和得分进行调度和结果视图。
- 使用NRL积分榜的排名仪表板，包括主场/客场分裂。
- 深度比赛页面，包含阵容、事件和统计数据。
所有内容都通过您的Zyla账户运行，使用一个API密钥和订阅。您可以从列表页面探索API并开始试用，以便在您的环境中进行测试。
在Zyla API Hub上开始
打开API页面，点击订阅或开始免费试用，并获取您的API密钥。身份验证很简单：在头部发送Authorization: Bearer YOUR_API_KEY。Zyla使用订阅+配额模型（不是按调用付费）。对于此API，项目页面上提供7天的试用。Zyla托管超过10,000个公共API的目录，使用一个账户和一个API密钥跨越所有列表。
- API列表： 在橄榄球实时数据API上开始7天试用
- 探索市场： Zyla API Hub
端点：获取支持的比赛
此端点返回当前活动的橄榄球比赛列表，包括您将在其他端点中重用的数字ID和赛季字段。使用它来驱动选择器，验证比赛的可用性，并存储ID以供后续调用。
HTTP方法和URL
- 方法：GET
- URL：https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions
- 身份验证：Authorization头（Bearer）
- 参数：无文档
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": "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":…您将实际连接的字段：
- results[].id：存储此整数——在接受比赛ID的其他端点中使用。
- results[].name：在您的下拉菜单或列表中呈现。
- results[].season和season_name：用于标记和范围后续查询。
Python示例：获取并显示比赛
import requests
API_KEY = "YOUR_API_KEY"
URL = "https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions"
resp = requests.get(URL, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=30)
resp.raise_for_status()
data = resp.json()
# 基本的合理性检查
meta = data.get("meta", {})
competitions = data.get("results", [])
print(f"标题: {meta.get('title')}")
for comp in competitions:
cid = comp.get("id")
name = comp.get("name")
season = comp.get("season")
season_name = comp.get("season_name")
print(f"{cid}: {name} — {season_name} ({season})")提示：
- 缓存此响应几分钟，以避免在每次页面加载时进行冗余调用。
- 持久化id和赛季，以便用户可以通过比赛/赛季深度链接到比赛安排和积分榜。
您可以在发现比赛后链式调用的补充端点
一旦您知道支持的内容，您可以从同一API获取特定内容。以下是您可以使用相同Authorization头调用的相关文档端点。
NRL比赛安排：一轮中的比赛
- 方法：GET
- URL：https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture
- 参数（必需）：
- season：数字（示例：2024）
- round：数字（示例：16）
示例响应（截断为文档字段）：
{
"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 Challenge Cup",
"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":…用例：
- 构建每轮的比赛安排，包括开球时间和场地。
- 在可用时显示最终得分。
- 将match_id链接到您应用中的更深层比赛视图。
NRL积分榜：主场/客场分裂的排名
- 方法：GET
- URL：https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder
- 参数（必需）：
- season：数字（示例：2024）
示例响应（截断为文档字段）：
使用主场、客场和整体块来显示细粒度的表现分裂。积分榜值是字符串；如果您需要数字计算，请在代码中解析/规范化它们。
获取比赛数据：橄榄球联合会比赛的阵容、事件和统计数据
- 方法：GET
- URL：https://zylalabs.com/api/796/rugby-live-data-api/538/get-match-data
- 参数：无文档
示例响应（截断为文档字段）：
此数据流包括比赛元数据和状态的结构（例如，半场、结果）。使用comp_id与您的支持比赛数据链接比赛回到比赛和赛季。
将其结合起来：一个最小的工作流程
- 调用获取支持的比赛以获取所有活动比赛的id、名称和赛季。
- 让用户在您的UI中选择比赛和赛季。
- 对于NRL特定视图，查询：
- 按赛季和轮次获取NRL比赛安排以呈现比赛安排和得分。
- 按赛季获取NRL积分榜以显示主场/客场分裂的排名。
- 对于橄榄球联合会比赛，调用获取比赛数据以显示阵容、事件和统计数据。
通过MCP从AI代理调用API
如果您正在与MCP兼容的客户端（例如Claude Code、Cursor、Windsurf）进行编排，您可以通过Zyla MCP端点路由调用。在初始化工具时提供您的Zyla API密钥，并发出上述相同的hub URL。
文档和端点： MCP。代理可以使用Authorization头发出GET请求，并返回您的工作流程的JSON。保持提示明确关于确切的hub URL和所需的查询参数（例如，NRL比赛安排的赛季和轮次）。
节省时间的生产笔记
- 身份验证：每次调用都需要Authorization: Bearer YOUR_API_KEY。
- 时间戳：在存在的地方（例如，比赛数据中的日期），它们是UTC和ISO格式，符合架构描述。
- 缓存：支持的比赛变化不频繁；缓存几分钟到几小时。比赛安排和积分榜更新更频繁——在比赛日更保守地缓存。
- 解析：某些数字值以字符串形式到达；在聚合之前进行规范化（例如，积分榜points_difference）。
- 订阅：访问是订阅+配额。检查API页面以获取当前访问选项和定价。项目页面上提供7天的试用。
- 市场导航：您可以从您的Zyla账户管理密钥、配额和日志。随时在 zylalabs.com 浏览其他体育端点。
现实世界用例
- 比赛发现：构建一个动态的“选择比赛和赛季”步骤，始终反映当前活动的比赛。
- 比赛中心：结合NRL比赛安排和获取比赛数据以呈现完整的比赛中心：开球详情、得分和深入统计。
- 排名仪表板：每晚刷新NRL积分榜，以保持当前的排行榜，显示主场/客场表现。
- 数据导出管道：定期将支持的比赛和ID导出到您的数据仓库，然后与比赛安排和比赛事件连接。
常见问题
我如何进行身份验证？
在每个请求中发送头部Authorization: Bearer YOUR_API_KEY到上述hub URL。
哪个端点返回支持比赛的列表？
使用GET https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions。没有文档参数；包括您的Authorization头。
我如何获取某一轮的NRL比赛安排？
调用GET https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture，带上赛季和轮次查询参数。
我如何获取当前的NRL积分榜？
调用GET https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder，带上赛季参数。
我可以从AI代理调用这些API吗？
可以。使用Zyla MCP端点，带上您的API密钥，并对hub URL发出相同的GET请求。
准备好发布您的集成了吗？创建您的账户，获取API密钥，并从列表页面开始您的7天试用： 在橄榄球实时数据API上开始7天试用。在 Zyla API Hub 浏览成千上万的其他体育和游戏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 Challenge Cup",
"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":…
