Você está tentando enviar uma visualização de fixtures da NRL esta semana e precisa de partidas confiáveis, horários de início, locais e resultados — além de uma tabela para as classificações. Ao final deste guia, você chamará um endpoint real que retorna o fixture da NRL para uma determinada temporada e rodada, analisará em código e entenderá como buscar a tabela e dados detalhados das partidas usando a mesma chave de API.
O que esta API retorna e por que é útil
A API de Dados ao Vivo de Rugby no Zyla API Hub expõe dados estruturados da NRL que você pode integrar rapidamente em produtos:
- Fixture da NRL: partidas para uma determinada temporada e rodada, com equipes, horário de início, local e resultado.
- Tabela da NRL: classificações com registros de casa, fora e gerais por equipe.
- Dados da Partida (rugby union): pontuação detalhada, árbitros, escalações, estatísticas e eventos, incluindo timestamps ISO 8061 em UTC conforme descrito no esquema de resposta.
Equipes que constroem placares, ferramentas de apostas, aplicativos de companheiros de transmissão e painéis de análise podem usar esses endpoints com uma chave de API e um padrão de autenticação consistente.
Se você também está navegando em outras categorias, o Zyla API Hub agrega mais de 10.000 APIs públicas sob uma única assinatura e chave, para que você possa manter sua superfície de integração pequena.
Começando no Zyla API Hub
Abra a página da API de Dados ao Vivo de Rugby, clique em Assinar (ou Iniciar Teste Gratuito quando disponível) e recupere sua chave de API. A autenticação é um cabeçalho HTTP:
- Cabeçalho: Authorization: Bearer YOUR_API_KEY
A cobrança é por assinatura + cota (não por chamada). Para uma primeira integração, você normalmente terá um teste de 7 dias ou 50 solicitações para validar sua construção. Não há Plano Gratuito — verifique a página da API para opções de acesso e preços atuais. Você pode explorar conjuntos de dados esportivos adicionais a qualquer momento no catálogo do Zyla API Hub com a mesma conta.
Fixture da NRL: temporada e rodada
O endpoint de Fixture da NRL retorna todas as partidas em uma rodada específica, incluindo equipes, informações de início, local e resultados finais onde disponíveis. As temporadas vão até 2002.
- Método: GET
- URL: https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture
- Parâmetros obrigatórios:
- season (número): 2024
- round (número): 16
exemplo de cURL
curl -s -X GET "https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions" \
-H "Authorization: Bearer YOUR_API_KEY"Resposta real (truncada para amostra oficial)
{
"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":…O que você realmente usará em um aplicativo:
- data.season e data.round: para rotular a visualização da rodada.
- fixtures[].home_team, fixtures[].away_team, fixtures[].time, fixtures[].venue: para renderizar cartões de partidas.
- fixtures[].home_score e fixtures[].away_score: para partidas concluídas.
- fixtures[].match_id: para construir links diretos para suas páginas internas de partidas.
Exemplo em Python: renderizar um cronograma de rodadas
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 did not return success")
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 "TBD"
print(f"{date} {when} | {home} vs {away} @ {venue} | {score}")Tabela da NRL: classificações e registros das equipes
O endpoint da Tabela da NRL retorna as classificações de uma temporada com desagregações por equipe (casa, fora, geral). As temporadas vão até 2002.
- Método: GET
- URL: https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder
- Parâmetro obrigatório:
- season (número): 2024
exemplo de cURL
Resposta real (truncada para amostra oficial)
Campos principais para telas de classificações:
- ladder.position e ladder.team: para ordenar e rotular linhas.
- overall.wins, overall.losses, overall.ladder_points: para calcular a lógica de classificação na interface do usuário.
- registros de casa/fora: para adicionar divisões ou filtrar visualizações.
Detalhes da partida (rugby union): pontuação, escalações, eventos
Se você também cobre rugby union, o endpoint de Dados da Partida retorna informações detalhadas da partida: pontuação, árbitros, escalações, estatísticas e eventos. Isso é útil para pontuações detalhadas e jogadas por jogadas.
- Método: GET
- URL: https://zylalabs.com/api/796/rugby-live-data-api/538/get-match-data
- Parâmetros: nenhum está documentado aqui. Chame apenas com autenticação.
exemplo de cURL
Resposta (excerto do esquema da amostra oficial)
Observe a orientação do timestamp: ISO 8061 em UTC, que simplifica a normalização do lado do servidor entre fusos horários.
Amostra oficial: lista de competições suportadas
Use isso para inventariar as competições que a API cobre. A resposta mostra IDs e temporadas que você pode alimentar em outros endpoints quando aplicável.
{
"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":…Notas práticas de implementação
- Autenticação: sempre envie Authorization: Bearer YOUR_API_KEY.
- Formato da solicitação: os endpoints da NRL documentados aqui aceitam temporada e rodada onde especificado. Não adicione parâmetros não listados.
- Cache: fixtures e tabelas são estáveis dentro de uma rodada; caching conservador (por exemplo, por rodada) pode reduzir a rotatividade. Para cenários ao vivo, ajuste os TTLs à sua estratégia de atualização.
- Timestamps: no esquema de dados da partida, os timestamps são ISO 8061 e sempre UTC, conforme documentado nos campos de resposta.
- Quotas: assinatura + cota; para o primeiro uso, você normalmente recebe um teste de 7 dias ou 50 solicitações. Monitore seu uso no painel do Hub.
Chamada de agentes de IA via MCP
Você pode chamar esses endpoints de ferramentas compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf) usando o endpoint MCP da Zyla. Forneça sua chave de API e deixe o agente orquestrar chamadas:
- Endpoint MCP: MCP
- Chave da API: passe-a para o cliente MCP para que ele possa enviar Authorization: Bearer YOUR_API_KEY em solicitações para os endpoints do Zyla API Hub.
Isso é útil para prototipar fluxos de trabalho como “buscar fixtures da NRL da rodada 16 e resumir resultados”, diretamente em seu ambiente de desenvolvimento.
Casos de uso do mundo real que você pode implementar esta semana
- Centro de rodadas: renderizar a grade de fixtures da rodada da NRL com logotipos das equipes e linhas de início. Use match_id para vincular à sua visualização de detalhes.
- Painel de classificações: mostrar a tabela com divisões de casa/fora e ladder_points, classificável por points_difference.
- Ticker de resultados: consultar o endpoint de fixtures para exibir resultados finais à medida que se tornam disponíveis dentro da rodada.
- Prévia da partida: combinar nomes das equipes do fixture e local com seu conteúdo editorial ou feed de odds.
Dicas de solução de problemas
- Não autorizado: confirme se o cabeçalho Authorization está presente e corretamente formado.
- Fixtures vazias: certifique-se de que está passando os valores de temporada e rodada exatamente como números.
- Normalização de dados: os campos de pontuação são strings em amostras; converta para inteiros conforme necessário em seu modelo de domínio.
FAQ
Quais temporadas os dados da NRL cobrem?
Os endpoints de Fixture da NRL e Tabela da NRL retornam temporadas até 2002.
Em qual fuso horário estão os horários das partidas no fixture?
A amostra do fixture mostra data e hora como strings. O feed detalhado da partida de rugby union documenta timestamps ISO 8061 em UTC; para o fixture da NRL, trate a formatação de strings conforme fornecido pelo endpoint.
Preciso de parâmetros de consulta para o endpoint de Dados da Partida?
Nenhum parâmetro está documentado neste guia para Obter Dados da Partida. Você pode chamá-lo apenas com autenticação, conforme mostrado.
Como a cobrança é tratada?
Assinatura + cota. Não há Plano Gratuito. Para o primeiro uso, espere um teste de 7 dias ou 50 solicitações; verifique a página da API para opções de acesso e preços atuais.
Posso acionar isso a partir de um agente de codificação de IA?
Sim. Use o endpoint MCP da Zyla e forneça sua chave de API para que o agente possa realizar chamadas autenticadas para os endpoints do Hub.
Pronto para integrar o fixture e a tabela da NRL em seu aplicativo? Crie sua conta, obtenha uma chave de API e comece seu teste de 7 dias aqui: Iniciar teste de 7 dias na API de Dados ao Vivo de Rugby.
Resposta oficial da API
{
"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":…
