Integre a API NRL em JavaScript Usando o Zyla API Hub (Guia)

Você precisa enviar um widget de classificação e programação da NRL esta semana. Ao final deste guia, você fará consultas à API NRL do Zyla API Hub usando o fetch do JavaScript, renderizará a tabela atual para uma temporada, puxará as partidas para uma rodada específica e detalhará os detalhes de uma partida específica—pronto para ser inserido em seu aplicativo ou painel.

O que você obtém com a API NRL no Zyla API Hub

A API NRL fornece dados estruturados de rugby league que você pode consumir diretamente do seu frontend ou backend:

Ilustração: Integre a API NRL em JavaScript Usando o Zyla API Hub (Guia)

Tabela: classificações atuais para a temporada que você escolher (suporta o ano atual e de 2002 em diante).
Partida: programação e pontuações dos jogos para a rodada que você escolher (temporada atual e de 2002 em diante).
Detalhes da partida: informações detalhadas para um ID de partida do endpoint Fixture, incluindo pontuações e escalações.

Está listado no marketplace do Zyla API Hub, que agrega mais de 10.000 APIs públicas sob uma única conta, uma chave de API e um modelo de assinatura. Você pode navegar pela listagem da API NRL aqui: API NRL.

Começando no Zyla API Hub

A configuração leva minutos:

Abra a página da API NRL no Zyla API Hub.
Clique em Inscrever-se. Os planos utilizam assinatura + cota (não pagamento por chamada). A primeira API em uma nova conta geralmente inclui um teste de 7 dias ou 50 solicitações. Não há Plano Gratuito. Verifique a página da API para opções de acesso e preços atuais.
Copie sua chave de API.

Todas as chamadas usam um cabeçalho de Autorização:

Autorização: Bearer SUA_CHAVE_API

Se você ainda não tem uma conta, pode criar uma aqui: Registrar.

Visão geral dos endpoints

Padrão base para todas as solicitações neste guia: https://zylalabs.com/api/... com Autorização: Bearer SUA_CHAVE_API. Abaixo estão os endpoints disponíveis para a API NRL junto com as URLs exatas e parâmetros que você pode usar.

Tabela (GET)

Retorna as estatísticas atuais da tabela para a temporada que você escolher. Você pode usar o ano atual ou qualquer temporada de 2002 em diante.

Método: GET
URL: https://zylalabs.com/api/4554/nrl-api/5601/ladder
Parâmetro de consulta obrigatório:
- season (número): valor de exemplo 2025

Exemplo oficial de curl (pronto para copiar e colar):

curl -s -X GET "https://zylalabs.com/api/4554/nrl-api/5601/ladder?season=2025" \
-H "Authorization: Bearer SUA_CHAVE_API"

Exemplo oficial de resposta 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…

Como ler rapidamente:

status: string indicando sucesso.
data: array de entradas da tabela. Cada entrada tem:
- season: o rótulo da temporada.
- ladder: um objeto com campos como position, team, played, wins, losses, draws, bye, for, against, ladder_points.

Partida (GET)

Retorna a programação para uma rodada específica em uma temporada específica. Use-o para exibir horários, pontuações de rodadas anteriores ou informações sobre rodadas futuras.

Método: GET
URL: https://zylalabs.com/api/4554/nrl-api/5602/fixture
Parâmetros de consulta obrigatórios:
- season (número): valor de exemplo 2024
- round (número): valor de exemplo 1

exemplo de curl:

A resposta inclui a temporada, rótulo da rodada e um array de partidas com match_id, data, hora, nomes das equipes, pontuações/pontos, árbitro, local e público. Use os valores de match_id para solicitar detalhes da partida.

Detalhes da Partida (GET)

Dado um match_id do endpoint Fixture, recupere detalhes como a folha de pontuação e as escalações.

Método: GET
URL: https://zylalabs.com/api/4554/nrl-api/5603/match-details
Parâmetro de consulta obrigatório:
- match_id (número): valor de exemplo 62004

exemplo de curl:

A resposta inclui status da partida, data, hora de início, árbitro, local, público, home_team, away_team e um objeto match_details (com dados aninhados de match_score, folha de pontuação e escalações).

Fetch do JavaScript: renderização da tabela de ponta a ponta

O seguinte código JavaScript chama o endpoint Ladder, extrai alguns campos comuns e registra um array mínimo de classificações que você pode renderizar em seu aplicativo. Ele usa o mesmo endpoint e parâmetros que o curl oficial acima.

// Rótulo: exemplo de JavaScript (Tabela)
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 SUA_CHAVE_API"
}
});

if (!res.ok) {
const text = await res.text();
throw new Error("A solicitação da API NRL falhou: " + res.status + " - " + text);
}

const json = await res.json();

// Espera-se a forma: { 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)); // verificação rápida da parte superior 8
}

fetchNrlLadder().catch(console.error);

Notas:

Mantenha sua chave de API no código do lado do servidor ou em uma variável de ambiente. Se você precisar chamar de um navegador, faça o proxy da solicitação através do seu backend.
Cache as respostas da tabela por temporada para reduzir chamadas; a tabela muda após as rodadas serem concluídas, em vez de minuto a minuto.

Padrões de integração práticos

1) Widget de classificações semanais

Chame o endpoint Ladder uma vez após cada rodada. Persista a resposta para que seu frontend renderize instantaneamente a tabela mais recente. Exiba os campos: position, team, played, wins, losses, for, against, ladder_points.

2) Página de programação rodada a rodada

Use o endpoint Fixture para a temporada e rodada selecionadas. Renderize a data, hora, home_team, away_team, local e público. Onde disponível, mostre home_score ou away_points para partidas concluídas. Vincule cada linha a uma página de detalhes da partida usando match_id.

3) Centro de partidas

Na página de detalhes da partida, busque detalhes da partida com o match_id do fixture. Exiba match_status, kick_off, árbitro e local. Mostre os campos match_score (home_score, away_score, divisões de intervalo) e escalações.

4) Estratégia mínima de cache

Tabela: cache por temporada; atualize em um cronograma alinhado à conclusão da rodada.
Fixture: cache por temporada+rodada; atualize se detectar alterações nas pontuações à medida que as partidas forem concluídas.
Detalhes da partida: cache por match_id com TTL de curta duração enquanto um jogo estiver em andamento, depois armazene como final quando concluído.

Exemplos de cURL para copiar e colar

Você pode verificar rapidamente sua configuração com essas solicitações exatas (elas requerem o cabeçalho de Autorização e sua chave). Essas URLs são da listagem da API NRL no Zyla API Hub.

Tabela

Partida (temporada + rodada)

Detalhes da partida (por match_id)

Chamando a API NRL de agentes de IA via MCP

Toda API no Zyla API Hub pode ser chamada de agentes de IA através do endpoint MCP: https://mcp.zylalabs.com/mcp?apikey=SUA_CHAVE_API. Isso funciona com clientes compatíveis com MCP, como Claude Code, Cursor e Windsurf. Seu agente pode solicitar as mesmas URLs da API NRL mostradas acima; a camada MCP encaminha solicitações usando suas credenciais do Zyla API Hub.

Para mais informações sobre o uso do MCP, veja: MCP.

Dicas e pegadinhas de confiabilidade

Autenticação: Sempre envie Autorização: Bearer SUA_CHAVE_API.
Parâmetros: Passe apenas os parâmetros documentados para cada endpoint (season, round, match_id). Não envie corpos nessas solicitações GET.
Tratamento de erros: Trate respostas não 2xx como erros e registre o corpo para diagnósticos.
Frescura dos dados: A tabela é atualizada à medida que a temporada avança; as partidas fornecem tanto pontuações passadas quanto programação futura. Os detalhes da partida incluem campos granulares uma vez que as partidas são concluídas.
Quotas: O Zyla usa assinatura + cota. A primeira API em uma nova conta geralmente inclui um teste de 7 dias ou 50 solicitações. Monitore seu uso e verifique a página da API para opções de acesso atuais.

Onde explorar e próximos passos

Navegue pela listagem da API NRL no Zyla: API NRL. O Zyla centraliza mais de 10.000 APIs públicas, para que você possa adicionar dados esportivos adicionais mais tarde, sem criar novas contas ou lidar com várias chaves.

FAQ

P: Qual cabeçalho de autenticação a API NRL requer?
R: Use Autorização: Bearer SUA_CHAVE_API em cada solicitação para as URLs do Zyla API Hub.

P: Quais parâmetros são obrigatórios para cada endpoint?
R: A tabela requer season. A partida requer season e round. Os detalhes da partida requerem match_id. Passe apenas aqueles parâmetros de consulta documentados.

P: Posso buscar temporadas históricas?
R: Sim. Os endpoints de Tabela e Partida suportam temporadas desde 2002, além do ano atual.

P: Existe um plano gratuito?
R: Não há Plano Gratuito. A primeira API em uma nova conta Zyla geralmente inclui um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.

P: Posso chamar a API de um agente de IA?
R: Sim. Use o endpoint MCP em https://mcp.zylalabs.com/mcp?apikey=SUA_CHAVE_API. Seu agente pode então chamar as mesmas URLs da API NRL.

Pronto para enviar? Crie sua conta, inscreva-se na API NRL e obtenha sua chave aqui: Registrar. Em seguida, insira os snippets de curl e JavaScript acima em seu aplicativo e implemente sua tabela NRL, partidas e centro de partidas esta semana.