API para obter competições suportadas

Você precisa de uma API para listar quais competições de rugby são suportadas para que seu aplicativo possa apresentar um dropdown, validar seleções de usuários ou inicializar IDs para consultas posteriores. Ao final deste artigo, você chamará um endpoint real que retorna as competições ativas, analisará seus campos e verá como combiná-lo com partidas, tabelas e dados de jogos—tudo a partir da mesma listagem no Zyla API Hub.

O que você obtém: Competições suportadas, partidas, tabelas e detalhes de jogos

A API de Dados ao Vivo de Rugby no Zyla API Hub expõe endpoints para descobrir competições ativas, buscar partidas da rodada da NRL, recuperar a tabela da NRL para uma temporada e obter dados detalhados de partidas de rugby union. Os usos típicos incluem:

• Preencher um seletor de “Competição” usando a lista oficial de competições suportadas (IDs e temporadas).
• Visões de programação e resultados com partidas e pontuações por rodada.
• Dashboards de classificações usando a tabela da NRL, incluindo divisões de casa/fora.
• Páginas de partidas detalhadas com escalações, eventos e estatísticas.

Tudo funciona através da sua conta Zyla com uma única chave de API e assinatura. Você pode explorar a API a partir da página de listagem e iniciar um teste para testar em seu ambiente.

Começando no Zyla API Hub

Abra a página da API, clique em Inscrever-se ou Iniciar Teste Gratuito e pegue sua chave de API. A autenticação é simples: envie Authorization: Bearer YOUR_API_KEY no cabeçalho. A Zyla utiliza um modelo de assinatura + cota (não é pagamento por chamada). Para esta API, um teste de 7 dias está disponível na página do item. A Zyla hospeda um catálogo de mais de 10.000 APIs públicas com uma conta e uma chave de API em todas as listagens.

• Listagem da API: Iniciar teste de 7 dias na API de Dados ao Vivo de Rugby
• Explore o marketplace: Zyla API Hub

Endpoint: Obter Competições Suportadas

Este endpoint retorna a lista de competições de rugby atualmente ativas, incluindo um ID numérico e campos de temporada que você reutilizará em outros endpoints. Use-o para acionar seletores, validar a disponibilidade da competição e armazenar IDs para chamadas posteriores.

Método HTTP e URL

• Método: GET
• URL: https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions
• Auth: Cabeçalho de autorização (Bearer)
• Parâmetros: nenhum documentado

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

{
"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":…

Campos que você realmente conectará:

• results[].id: Armazene este inteiro—use-o com outros endpoints que aceitam IDs de competição.
• results[].name: Renderize isso no seu dropdown ou lista.
• results[].season e season_name: Útil para rotular e delimitar consultas subsequentes.

Exemplo em Python: buscar e exibir competições

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()

# Verificações básicas de sanidade
meta = data.get("meta", {})
competitions = data.get("results", [])

print(f"Título: {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})")

Dicas:

• Cache esta resposta por vários minutos para evitar chamadas redundantes em cada carregamento de página.
• Persista id e season para que os usuários possam acessar diretamente as partidas e classificações por competição/temporada mais tarde.

Endpoints complementares que você pode encadear após descobrir competições

Uma vez que você sabe o que é suportado, pode buscar conteúdo específico da mesma API. Abaixo estão os endpoints relacionados, documentados que você pode chamar com o mesmo cabeçalho de Autorização.

Fixture da NRL: partidas em uma rodada

• Método: GET
• URL: https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture
• Parâmetros (obrigatórios):
  • season: número (exemplo: 2024)
  • round: número (exemplo: 16)

Resposta de exemplo (truncada para campos documentados):

{
"meta": {
"title": "API de Dados ao Vivo de Rugby - Lista de Competições",
"description": "Lista de competições de rugby atualmente ativas.",
"fields": {
"id": "Inteiro - use para consultar outros endpoints",
"name": "String - nome da competição",
"season": "Inteiro - use para consultar outros endpoints",
"season_name": "String - representação textual da temporada"
}
},
"results": [
{
"id": 30,
"name": "Internacional",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1218,
"name": "Gallagher Prem",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1230,
"name": "TOP 14",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1236,
"name": "Campeonato de Rugby Unido",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1260,
"name": "Bunnings Warehouse NPC",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1266,
"name": "Seis Nações",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1278,
"name": "Pro D2",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1446,
"name": "Campeonato Heartland",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1464,
"name": "Investec Champions Cup",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1470,
"name": "EPCR Challenge Cup",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1500,
"name": "Seis Nações Femininas",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1962,
"name": "Partida de Acesso ao Top 14",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1968,
"name": "Copa de Rugby Prem",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1980,
"name":…

Casos de uso:

• Construa cronogramas por rodada com horários de início e locais.
• Mostre pontuações finais quando disponíveis.
• Vincule match_id a uma visualização de partida mais profunda em seu aplicativo.

Tabela da NRL: classificações com divisões de casa/fora

• Método: GET
• URL: https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder
• Parâmetros (obrigatórios):
  • season: número (exemplo: 2024)

Resposta de exemplo (truncada para campos documentados):

Use os blocos de casa, fora e geral para exibir divisões de desempenho granulares. Os valores da tabela são strings; se você precisar de cálculos numéricos, analise/normative-os em seu código.

Obter Dados da Partida: escalações, eventos e estatísticas para uma partida de rugby union

• Método: GET
• URL: https://zylalabs.com/api/796/rugby-live-data-api/538/get-match-data
• Parâmetros: nenhum documentado

Resposta de exemplo (truncada para campos documentados):

Este feed inclui a estrutura para metadados e status da partida (por exemplo, Intervalo, Resultado). Use comp_id com seus dados de competições suportadas para vincular partidas de volta a uma competição e temporada.

Juntando tudo: um fluxo de trabalho mínimo

1. Chame Obter Competições Suportadas para buscar id, nome e temporada para todas as competições ativas.
2. Deixe o usuário escolher uma competição e temporada em sua interface.
3. Para visualizações específicas da NRL, consulte:
   • Fixture da NRL por temporada e rodada para renderizar o cronograma e as pontuações.
   • Tabela da NRL por temporada para classificações com divisões de casa/fora.
4. Para uma partida de rugby union, chame Obter Dados da Partida para mostrar escalações, eventos e estatísticas.

Chamando a API de um agente de IA via MCP

Se você está orquestrando com clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf), pode direcionar chamadas através do endpoint MCP da Zyla. Forneça sua chave de API Zyla ao inicializar a ferramenta e emita as mesmas URLs do hub mostradas acima.

Docs e endpoint: MCP. O agente pode fazer solicitações GET com o cabeçalho de Autorização e retornar o JSON para seu fluxo de trabalho. Mantenha os prompts explícitos sobre a URL exata do hub e os parâmetros de consulta necessários (por exemplo, temporada e rodada para Fixture da NRL).

Notas de produção que economizam tempo

• Autenticação: Cada chamada requer Authorization: Bearer YOUR_API_KEY.
• Carimbos de data/hora: Onde presentes (por exemplo, data em Dados da Partida), eles estão no formato UTC e ISO conforme a descrição do esquema.
• Cache: Competições suportadas mudam com pouca frequência; cache por minutos a horas. Fixtures e tabelas são atualizadas com mais frequência—cache mais conservadoramente em dias de partidas.
• Análise: Alguns valores numéricos chegam como strings; normalize antes de agregações (por exemplo, diferença de pontos da tabela).
• Assinatura: O acesso é por assinatura + cota. Verifique a página da API para opções de acesso e preços atuais. Um teste de 7 dias está disponível a partir da página de listagem.
• Navegação no marketplace: Você pode gerenciar chaves, cotas e logs a partir da sua conta Zyla. Navegue por endpoints adicionais de esportes a qualquer momento em zylalabs.com.

Casos de uso do mundo real

• Descoberta de competições: Construa um passo dinâmico “Escolha competição e temporada” que sempre reflita as competições ativas atualmente.
• Centro de partidas: Combine Fixture da NRL e Obter Dados da Partida para apresentar um centro de partidas completo: detalhes do início, pontuação e estatísticas detalhadas.
• Dashboard de classificações: Atualize a Tabela da NRL todas as noites para manter um leaderboard atual com desempenho em casa/fora.
• Pipeline de exportação de dados: Exporte periodicamente competições suportadas e IDs para seu armazém de dados, depois junte-se a fixtures e eventos de partidas.

FAQ

Como faço para autenticar?
Envie o cabeçalho Authorization: Bearer YOUR_API_KEY com cada solicitação para as URLs do hub mostradas acima.

Qual endpoint retorna a lista de competições suportadas?
Use GET https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions. Nenhum parâmetro está documentado; inclua seu cabeçalho de Autorização.

Como faço para obter fixtures da NRL para uma rodada?
Chame GET https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture com os parâmetros de consulta de temporada e rodada.

Como posso buscar a tabela atual da NRL?
Chame GET https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder com o parâmetro de temporada.

Posso chamar essas APIs de agentes de IA?
Sim. Use o endpoint Zyla MCP com sua chave de API e emita as mesmas solicitações GET para as URLs do hub.

Pronto para enviar sua integração? Crie sua conta, obtenha uma chave de API e inicie seu teste de 7 dias a partir da página de listagem: Iniciar teste de 7 dias na API de Dados ao Vivo de Rugby. Navegue por milhares de outras APIs de esportes e jogos em Zyla API Hub.

Resposta oficial da API

{
"meta": {
"title": "API de Dados ao Vivo de Rugby - Lista de Competições",
"description": "Lista de competições de rugby atualmente ativas.",
"fields": {
"id": "Inteiro - use para consultar outros endpoints",
"name": "String - nome da competição",
"season": "Inteiro - use para consultar outros endpoints",
"season_name": "String - representação textual da temporada"
}
},
"results": [
{
"id": 30,
"name": "Internacional",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1218,
"name": "Gallagher Prem",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1230,
"name": "TOP 14",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1236,
"name": "Campeonato de Rugby Unido",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1260,
"name": "Bunnings Warehouse NPC",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1266,
"name": "Seis Nações",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1278,
"name": "Pro D2",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1446,
"name": "Campeonato Heartland",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1464,
"name": "Investec Champions Cup",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1470,
"name": "EPCR Challenge Cup",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1500,
"name": "Seis Nações Femininas",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1962,
"name": "Partida de Acesso ao Top 14",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1968,
"name": "Copa de Rugby Prem",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1980,
"name":…