Estás intentando implementar una vista de calendario de NRL esta semana y necesitas partidos confiables ronda por ronda, horarios de inicio, sedes y puntajes, además de una tabla para las posiciones. Al final de esta guía, llamarás a un endpoint real que devuelve el calendario de NRL para una temporada y ronda dadas, lo analizarás en código y entenderás cómo obtener la tabla y los datos detallados de los partidos utilizando la misma clave de API.
Qué devuelve esta API y por qué es útil
La API de Datos en Vivo de Rugby en Zyla API Hub expone datos estructurados de NRL que puedes integrar rápidamente en productos:
- Calendario de NRL: partidos para una temporada y ronda dadas, con equipos, inicio, sede y puntaje.
- Tabla de NRL: posiciones con récords por equipo en casa, fuera y en general.
- Datos del partido (rugby union): puntaje detallado, árbitros, alineaciones, estadísticas y eventos, incluyendo marcas de tiempo ISO 8061 en UTC como se describe en el esquema de respuesta.
Los equipos que construyen tableros de puntajes, herramientas de apuestas, aplicaciones de acompañamiento de transmisión y paneles de análisis pueden usar estos endpoints con una clave de API y un patrón de autenticación consistente.
Si también estás navegando por otras categorías, el Zyla API Hub marketplace agrega más de 10,000 APIs públicas bajo una suscripción y clave, para que puedas mantener tu superficie de integración pequeña.
Comenzando en Zyla API Hub
Abre la página de la API de Datos en Vivo de Rugby, haz clic en Suscribirse (o Comenzar Prueba Gratuita cuando esté disponible) y recupera tu clave de API. La autenticación es un encabezado HTTP:
- Encabezado: Authorization: Bearer YOUR_API_KEY
La facturación es suscripción + cuota (no pago por llamada). Para una primera integración, típicamente tendrás una prueba de 7 días o 50 solicitudes para validar tu construcción. No hay Plan Gratuito; consulta la página de la API para las opciones de acceso y precios actuales. Puedes explorar conjuntos de datos deportivos adicionales en cualquier momento desde el catálogo de Zyla API Hub con la misma cuenta.
Calendario de NRL: temporada y ronda
El endpoint del calendario de NRL devuelve todos los partidos en una ronda específica, incluyendo equipos, información de inicio, sede y puntajes finales donde estén disponibles. Las temporadas se remontan a 2002.
- Método: GET
- URL: https://zylalabs.com/api/796/rugby-live-data-api/5585/nrl-fixture
- Parámetros requeridos:
- season (número): 2024
- round (número): 16
ejemplo 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"Respuesta real (truncada a muestra 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":…Lo que realmente usarás en una aplicación:
- data.season y data.round: para etiquetar la vista de la ronda.
- fixtures[].home_team, fixtures[].away_team, fixtures[].time, fixtures[].venue: para renderizar tarjetas de partidos.
- fixtures[].home_score y fixtures[].away_score: para partidos completados.
- fixtures[].match_id: para construir enlaces profundos a tus páginas internas de partidos.
ejemplo de Python: renderizar un calendario de ronda
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}")Tabla de NRL: posiciones y récords de equipos
El endpoint de la tabla de NRL devuelve las posiciones de una temporada con desgloses por equipo (en casa, fuera, en general). Las temporadas se remontan a 2002.
- Método: GET
- URL: https://zylalabs.com/api/796/rugby-live-data-api/5586/nrl-ladder
- Parámetro requerido:
- season (número): 2024
ejemplo de cURL
Respuesta real (truncada a muestra oficial)
Campos clave para pantallas de posiciones:
- ladder.position y ladder.team: para ordenar y etiquetar filas.
- overall.wins, overall.losses, overall.ladder_points: para calcular la lógica de rango en la interfaz de usuario.
- récords en casa/fuera: para agregar divisiones o filtrar vistas.
Detalles del partido (rugby union): puntaje, alineaciones, eventos
Si también cubres rugby union, el endpoint de Datos del Partido devuelve información detallada del partido: puntaje, árbitros, alineaciones, estadísticas y eventos. Esto es útil para puntajes detallados y jugada por jugada.
- Método: GET
- URL: https://zylalabs.com/api/796/rugby-live-data-api/538/get-match-data
- Parámetros: ninguno está documentado aquí. Llama solo con autenticación.
ejemplo de cURL
Respuesta (extracto del esquema de muestra oficial)
Nota la guía de marcas de tiempo: ISO 8061 en UTC, lo que simplifica la normalización del lado del servidor a través de zonas horarias.
Muestra oficial: lista de competiciones soportadas
Usa esto para inventariar las competiciones que cubre la API. La respuesta muestra IDs y temporadas que puedes alimentar en otros endpoints cuando sea aplicable.
{
"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 de implementación práctica
- Autenticación: siempre envía Authorization: Bearer YOUR_API_KEY.
- Forma de solicitud: los endpoints de NRL documentados aquí aceptan temporada y ronda donde se especifica. No agregues parámetros no listados.
- Cacheo: los calendarios y tablas son estables dentro de una ronda; el cacheo conservador (por ejemplo, por ronda) puede reducir la rotación. Para escenarios en vivo, ajusta los TTL a tu estrategia de actualización.
- Marcas de tiempo: en el esquema de datos del partido, las marcas de tiempo son ISO 8061 y siempre UTC como se documenta en los campos de respuesta.
- Cuotas: suscripción + cuota; para el primer uso típicamente obtienes una prueba de 7 días o 50 solicitudes. Monitorea tu uso en el panel de control de Hub.
Llamadas desde agentes de IA a través de MCP
Puedes llamar a estos endpoints desde herramientas compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf) usando el endpoint MCP de Zyla. Proporciona tu clave de API y deja que el agente orqueste las llamadas:
- Endpoint MCP: MCP
- Clave de API: pásala al cliente MCP para que pueda enviar Authorization: Bearer YOUR_API_KEY en las solicitudes a los endpoints de Zyla API Hub.
Esto es útil para prototipar flujos de trabajo como “obtener los calendarios de NRL de la ronda 16 y resumir resultados”, directamente en tu entorno de desarrollo.
Casos de uso del mundo real que puedes implementar esta semana
- Centro de ronda: renderiza la cuadrícula del calendario de NRL con logotipos de equipos y líneas de inicio. Usa match_id para vincular a tu vista de detalles.
- Panel de posiciones: muestra la tabla con divisiones en casa/fuera y ladder_points, ordenable por points_difference.
- Ticker de resultados: consulta el endpoint del calendario para mostrar puntajes finales a medida que estén disponibles dentro de la ronda.
- Vista previa previa al partido: combina los nombres de los equipos del calendario y la sede con tu contenido editorial o feed de cuotas.
Consejos de solución de problemas
- No autorizado: confirma que el encabezado de autorización esté presente y correctamente formado.
- Calendarios vacíos: asegúrate de que estás pasando tanto los valores de temporada como de ronda exactamente como números.
- Normalización de datos: los campos de puntaje son cadenas en las muestras; conviértelos a enteros según sea necesario en tu modelo de dominio.
FAQ
¿Qué temporadas cubre los datos de NRL?
Los endpoints del calendario de NRL y la tabla de NRL devuelven temporadas desde 2002.
¿En qué zona horaria están los horarios de los partidos en el calendario?
La muestra del calendario muestra la fecha y la hora como cadenas. El feed detallado de partidos de rugby union documenta marcas de tiempo ISO 8061 en UTC; para el calendario de NRL, maneja el formato de cadena como lo proporciona el endpoint.
¿Necesito parámetros de consulta para el endpoint de Datos del Partido?
No se documentan parámetros en esta guía para Obtener Datos del Partido. Puedes llamarlo solo con autenticación como se muestra.
¿Cómo se maneja la facturación?
Suscripción + cuota. No hay Plan Gratuito. Para el primer uso, espera una prueba de 7 días o 50 solicitudes; consulta la página de la API para las opciones de acceso y precios actuales.
¿Puedo manejar esto desde un agente de codificación de IA?
Sí. Usa el endpoint MCP de Zyla y proporciona tu clave de API para que el agente pueda realizar llamadas autenticadas a los endpoints de Hub.
¿Listo para integrar el calendario y la tabla de NRL en tu aplicación? Crea tu cuenta, obtén una clave de API y comienza tu prueba de 7 días aquí: Comienza la prueba de 7 días en la API de Datos en Vivo de Rugby.
Respuesta oficial de la 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":…
