API para obtener competiciones soportadas

Necesitas una API para listar qué competiciones de rugby son soportadas para que tu aplicación pueda presentar un menú desplegable, validar selecciones de usuario o inicializar IDs para consultas posteriores. Al final de este artículo, llamarás a un endpoint real que devuelve las competiciones activas, analizarás sus campos y verás cómo combinarlo con partidos, tablas y datos de partidos, todo desde la misma lista en Zyla API Hub.

Lo que obtienes: Competiciones soportadas, partidos, tablas y detalles de partidos

La API de Datos en Vivo de Rugby en Zyla API Hub expone endpoints para descubrir competiciones activas, obtener los partidos de la ronda de la NRL, recuperar la tabla de la NRL para una temporada y obtener datos detallados de partidos de rugby union. Los usos típicos incluyen:

• Rellenar un selector de “Competición” utilizando la lista oficial de competiciones soportadas (IDs y temporadas).
• Vistas de programación y resultados con partidos y puntajes por ronda.
• Tableros de posiciones utilizando la tabla de la NRL, incluyendo divisiones de local/visitante.
• Páginas de partidos en profundidad con alineaciones, eventos y estadísticas.

Todo se gestiona a través de tu cuenta de Zyla con una sola clave API y suscripción. Puedes explorar la API desde la página de listado y comenzar una prueba para probar en tu entorno.

Comenzando en Zyla API Hub

Abre la página de la API, haz clic en Suscribirse o Comenzar Prueba Gratuita, y obtén tu clave API. La autenticación es simple: envía Authorization: Bearer YOUR_API_KEY en el encabezado. Zyla utiliza un modelo de suscripción + cuota (no pago por llamada). Para esta API, hay una prueba de 7 días disponible en la página del ítem. Zyla alberga un catálogo de más de 10,000 APIs públicas con una cuenta y una clave API a través de los listados.

• Listado de API: Comienza prueba de 7 días en la API de Datos en Vivo de Rugby
• Explora el mercado: Zyla API Hub

Endpoint: Obtener Competiciones Soportadas

Este endpoint devuelve la lista de competiciones de rugby actualmente activas, incluyendo un ID numérico y campos de temporada que reutilizarás en otros endpoints. Úsalo para impulsar selectores, validar la disponibilidad de competiciones y almacenar IDs para llamadas posteriores.

Método HTTP y URL

• Método: GET
• URL: https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions
• Autenticación: encabezado de autorización (Bearer)
• Parámetros: ninguno 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"

Respuesta

{
"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 realmente conectarás:

• results[].id: Almacena este entero; úsalo con otros endpoints que acepten IDs de competiciones.
• results[].name: Renderiza esto en tu menú desplegable o lista.
• results[].season y season_name: Útiles para etiquetar y delimitar consultas posteriores.

Ejemplo en Python: obtener y mostrar competiciones

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

# Comprobaciones básicas de sanidad
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})")

Consejos:

• Almacena esta respuesta durante varios minutos para evitar llamadas redundantes en cada carga de página.
• Persiste id y temporada para que los usuarios puedan enlazar directamente a partidos y posiciones por competición/temporada más tarde.

Endpoints complementarios que puedes encadenar después de descubrir competiciones

Una vez que sepas qué está soportado, puedes obtener contenido específico de la misma API. A continuación se presentan los endpoints relacionados y documentados que puedes llamar con el mismo encabezado de Autorización.

Fixture de NRL: partidos en una ronda

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

Ejemplo de respuesta (truncada a campos documentados):

{
"meta": {
"title": "API de Datos en Vivo de Rugby - Lista de Competiciones",
"description": "Lista de competiciones de rugby actualmente activas.",
"fields": {
"id": "Entero - usar para consultar otros endpoints",
"name": "Cadena - nombre de la competición",
"season": "Entero - usar para consultar otros endpoints",
"season_name": "Cadena - representación textual de la 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": "United Rugby Championship",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1260,
"name": "Bunnings Warehouse NPC",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1266,
"name": "Six Nations",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1278,
"name": "Pro D2",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1446,
"name": "Heartland Championship",
"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": "Women's Six Nations",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1962,
"name": "Top 14 Access Match",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1968,
"name": "Prem Rugby Cup",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1980,
"name":…

Casos de uso:

• Construir horarios por ronda con horarios de inicio y lugares.
• Mostrar puntajes finales cuando estén disponibles.
• Vincular match_id a una vista más profunda del partido en tu aplicación.

Tabla de NRL: posiciones con divisiones de local/visitante

• Método: GET
• URL: https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder
• Parámetros (requeridos):
  • season: número (ejemplo: 2024)

Ejemplo de respuesta (truncada a campos documentados):

Utiliza los bloques de local, visitante y general para mostrar divisiones de rendimiento granular. Los valores de la tabla son cadenas; si necesitas cálculos numéricos, analízalos/normálizalos en tu código.

Obtener Datos del Partido: alineaciones, eventos y estadísticas para un partido de rugby union

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

Ejemplo de respuesta (truncada a campos documentados):

Este feed incluye la estructura para metadatos y estado del partido (por ejemplo, Medio Tiempo, Resultado). Usa comp_id con tus datos de competiciones soportadas para vincular partidos de vuelta a una competición y temporada.

Uniéndolo todo: un flujo de trabajo mínimo

1. Llama a Obtener Competiciones Soportadas para obtener id, nombre y temporada de todas las competiciones activas.
2. Deja que el usuario elija una competición y temporada en tu interfaz.
3. Para vistas específicas de NRL, consulta:
   • Fixture de NRL por temporada y ronda para renderizar el horario y los puntajes.
   • Tabla de NRL por temporada para posiciones con divisiones de local/visitante.
4. Para un partido de rugby union, llama a Obtener Datos del Partido para mostrar alineaciones, eventos y estadísticas.

Llamando a la API desde un agente de IA a través de MCP

Si estás orquestando con clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf), puedes enrutar llamadas a través del endpoint MCP de Zyla. Proporciona tu clave API de Zyla al inicializar la herramienta y emite las mismas URL de hub mostradas arriba.

Documentación y endpoint: MCP. El agente puede hacer solicitudes GET con el encabezado de Autorización y devolver el JSON para tu flujo de trabajo. Mantén los prompts explícitos sobre la URL exacta del hub y los parámetros de consulta requeridos (por ejemplo, temporada y ronda para el Fixture de NRL).

Notas de producción que ahorran tiempo

• Autenticación: Cada llamada requiere Authorization: Bearer YOUR_API_KEY.
• Marcas de tiempo: Donde estén presentes (por ejemplo, fecha en Datos del Partido), son UTC y formato ISO según la descripción del esquema.
• Cacheo: Las competiciones soportadas cambian infrecuentemente; almacena en caché durante minutos a horas. Los fixtures y tablas se actualizan más a menudo; almacena en caché de manera más conservadora en los días de partidos.
• Análisis: Algunos valores numéricos llegan como cadenas; normaliza antes de agregaciones (por ejemplo, puntos de diferencia de la tabla).
• Suscripción: El acceso es por suscripción + cuota. Consulta la página de la API para las opciones de acceso y precios actuales. Hay una prueba de 7 días disponible desde la página de listado.
• Navegación en el mercado: Puedes gestionar claves, cuotas y registros desde tu cuenta de Zyla. Navega por endpoints deportivos adicionales en cualquier momento en zylalabs.com.

Casos de uso en el mundo real

• Descubrimiento de competiciones: Construye un paso dinámico de “Elegir competición y temporada” que siempre refleje las competiciones actualmente activas.
• Centro de partidos: Combina Fixture de NRL y Obtener Datos del Partido para presentar un centro de partidos completo: detalles de inicio, puntaje y estadísticas en profundidad.
• Tablero de posiciones: Actualiza la Tabla de NRL cada noche para mantener un tablero de líderes actual con rendimiento local/visitante.
• Tubería de exportación de datos: Exporta periódicamente competiciones soportadas e IDs a tu almacén de datos, luego únelos con fixtures y eventos de partidos.

Preguntas Frecuentes

¿Cómo me autentico?
Envía el encabezado Authorization: Bearer YOUR_API_KEY con cada solicitud a las URL de hub mostradas arriba.

¿Qué endpoint devuelve la lista de competiciones soportadas?
Usa GET https://zylalabs.com/api/796/rugby-live-data-api/532/get-supported-competitions. No se documentan parámetros; incluye tu encabezado de Autorización.

¿Cómo obtengo fixtures de NRL para una ronda?
Llama a GET https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture con los parámetros de consulta de temporada y ronda.

¿Cómo puedo obtener la tabla actual de NRL?
Llama a GET https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder con el parámetro de temporada.

¿Puedo llamar a estas APIs desde agentes de IA?
Sí. Usa el endpoint de Zyla MCP con tu clave API y emite las mismas solicitudes GET a las URL de hub.

¿Listo para enviar tu integración? Crea tu cuenta, obtén una clave API y comienza tu prueba de 7 días desde la página de listado: Comienza prueba de 7 días en la API de Datos en Vivo de Rugby. Navega por miles más de APIs deportivas y de juegos en Zyla API Hub.

Respuesta oficial de la API

{
"meta": {
"title": "API de Datos en Vivo de Rugby - Lista de Competiciones",
"description": "Lista de competiciones de rugby actualmente activas.",
"fields": {
"id": "Entero - usar para consultar otros endpoints",
"name": "Cadena - nombre de la competición",
"season": "Entero - usar para consultar otros endpoints",
"season_name": "Cadena - representación textual de la 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": "United Rugby Championship",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1260,
"name": "Bunnings Warehouse NPC",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1266,
"name": "Six Nations",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1278,
"name": "Pro D2",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1446,
"name": "Heartland Championship",
"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": "Women's Six Nations",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1962,
"name": "Top 14 Access Match",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1968,
"name": "Prem Rugby Cup",
"season": 2027,
"season_name": "Temporada 2027"
},
{
"id": 1980,
"name":…