Integra la API de NRL en JavaScript Usando Zyla API Hub (Guía)

Necesitas enviar un widget de clasificaciones y calendario de NRL esta semana. Al final de esta guía, consultarás la API de NRL desde Zyla API Hub usando fetch de JavaScript, renderizarás la clasificación actual para una temporada, obtendrás los partidos de una ronda determinada y profundizarás en los detalles de un partido específico, listo para integrar en tu aplicación o panel de control.

Lo que obtienes con la API de NRL en Zyla API Hub

La API de NRL proporciona datos estructurados de rugby league que puedes consumir directamente desde tu frontend o backend:

Ilustración: Integra la API de NRL en JavaScript Usando Zyla API Hub (Guía)

Clasificación: clasificaciones actuales para la temporada que elijas (soporta el año actual y desde 2002).
Calendario: programación de partidos y puntajes para la ronda que elijas (temporada actual y desde 2002).
Detalles del partido: información detallada para un ID de partido desde el endpoint de Calendario, incluyendo puntajes y alineaciones.

Está listado en el mercado de Zyla API Hub, que agrega más de 10,000 APIs públicas bajo una sola cuenta, una clave de API y un modelo de suscripción. Puedes navegar por la lista de la API de NRL aquí: API de NRL.

Comenzando en Zyla API Hub

La configuración toma minutos:

Abre la página de la API de NRL en Zyla API Hub.
Haz clic en Suscribirse. Los planes utilizan suscripción + cuota (no pago por llamada). La primera API en una nueva cuenta generalmente incluye una prueba de 7 días o 50 solicitudes. No hay Plan Gratuito. Consulta la página de la API para las opciones de acceso y precios actuales.
Copia tu clave de API.

Todas las llamadas utilizan un encabezado de Autorización:

Autorización: Bearer YOUR_API_KEY

Si aún no tienes una cuenta, puedes crear una aquí: Registrarse.

Descripción general de los endpoints

Patrón base para todas las solicitudes en esta guía: https://zylalabs.com/api/... con Autorización: Bearer YOUR_API_KEY. A continuación se presentan los endpoints disponibles para la API de NRL junto con las URL exactas y parámetros que puedes usar.

Clasificación (GET)

Devuelve las estadísticas de clasificación actuales para la temporada que elijas. Puedes usar el año actual o cualquier temporada desde 2002.

Método: GET
URL: https://zylalabs.com/api/4554/nrl-api/5601/ladder
Parámetro de consulta requerido:
- season (número): valor de ejemplo 2025

Ejemplo oficial de curl (listo para copiar y pegar):

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

Respuesta JSON de ejemplo oficial:

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

Cómo leerlo rápidamente:

status: cadena que indica éxito.
data: matriz de entradas de clasificación. Cada entrada tiene:
- season: la etiqueta de la temporada.
- ladder: un objeto con campos como position, team, played, wins, losses, draws, bye, for, against, ladder_points.

Calendario (GET)

Devuelve el calendario para una ronda dada en una temporada dada. Úsalo para mostrar horarios, puntajes de rondas anteriores o información sobre rondas futuras.

Método: GET
URL: https://zylalabs.com/api/4554/nrl-api/5602/fixture
Parámetros de consulta requeridos:
- season (número): valor de ejemplo 2024
- round (número): valor de ejemplo 1

Ejemplo de curl:

La respuesta incluye la temporada, etiqueta de ronda y una matriz de calendarios con match_id, fecha, hora, nombres de equipos, puntajes/puntos, árbitro, lugar y público. Usa los valores de match_id para solicitar detalles del partido.

Detalles del Partido (GET)

Dado un match_id del endpoint de Calendario, recupera detalles como la hoja de puntajes y alineaciones.

Método: GET
URL: https://zylalabs.com/api/4554/nrl-api/5603/match-details
Parámetro de consulta requerido:
- match_id (número): valor de ejemplo 62004

Ejemplo de curl:

La respuesta incluye estado del partido, fecha, hora de inicio, árbitro, lugar, público, home_team, away_team y un objeto match_details (con datos anidados de match_score, hoja de puntajes y alineaciones).

Fetch de JavaScript: renderización de clasificaciones de extremo a extremo

El siguiente código de JavaScript llama al endpoint de Clasificación, extrae algunos campos comunes y registra una matriz mínima de clasificaciones que puedes renderizar en tu aplicación. Utiliza el mismo endpoint y parámetros que el curl oficial anterior.

// Etiqueta: ejemplo de JavaScript (Clasificación)
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 YOUR_API_KEY"
}
});

if (!res.ok) {
const text = await res.text();
throw new Error("La solicitud a la API de NRL falló: " + res.status + " - " + text);
}

const json = await res.json();

// Esperar 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)); // verificación rápida de los 8 primeros
}

fetchNrlLadder().catch(console.error);

Notas:

Mantén tu clave de API en el código del lado del servidor o en una variable de entorno. Si debes llamar desde un navegador, envía la solicitud a través de tu backend.
Cachea las respuestas de la clasificación por temporada para reducir las llamadas; la clasificación cambia después de que se completan las rondas en lugar de minuto a minuto.

Patrones de integración prácticos

1) Widget de clasificaciones semanales

Llama al endpoint de Clasificación una vez después de cada ronda. Persiste la respuesta para que tu frontend renderice instantáneamente la tabla más reciente. Muestra los campos: posición, equipo, jugados, victorias, derrotas, a favor, en contra, puntos de clasificación.

2) Página de calendario ronda por ronda

Usa el endpoint de Calendario para la temporada y ronda seleccionadas. Renderiza la fecha, hora, home_team, away_team, lugar y público. Donde sea posible, muestra home_score o away_points para partidos completados. Enlaza cada fila a una página de detalles del partido usando match_id.

3) Centro de partidos

En la página de detalles del partido, obtén detalles del partido con el match_id del calendario. Muestra match_status, kick_off, árbitro y lugar. Muestra los campos de match_score (home_score, away_score, divisiones del medio tiempo) y alineaciones.

4) Estrategia de caché mínima

Clasificación: caché por temporada; actualiza en un horario alineado con la finalización de la ronda.
Calendario: caché por temporada+ronda; actualiza si detectas cambios en los puntajes a medida que se completan los partidos.
Detalles del partido: caché por match_id con TTL de corta duración mientras un juego está en progreso, luego almacena como final cuando se complete.

Ejemplos de cURL para copiar y pegar

Puedes verificar rápidamente tu configuración con estas solicitudes exactas (requieren el encabezado de Autorización y tu clave). Estas URL son de la lista de la API de NRL en Zyla API Hub.

Clasificación

Calendario (temporada + ronda)

Detalles del partido (por match_id)

Llamando a la API de NRL desde agentes de IA a través de MCP

Cada API en Zyla API Hub puede ser llamada desde agentes de IA a través del endpoint MCP: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY. Esto funciona con clientes compatibles con MCP como Claude Code, Cursor y Windsurf. Tu agente puede solicitar las mismas URL de la API de NRL mostradas arriba; la capa MCP reenvía solicitudes usando tus credenciales de Zyla API Hub.

Para más información sobre el uso de MCP, consulta: MCP.

Consejos y trucos de fiabilidad

Autenticación: Siempre envía Autorización: Bearer YOUR_API_KEY.
Parámetros: Solo pasa los parámetros documentados para cada endpoint (season, round, match_id). No envíes cuerpos en estas solicitudes GET.
Manejo de errores: Trata las respuestas no 2xx como errores y registra el cuerpo para diagnósticos.
Frescura de datos: La clasificación se actualiza a medida que avanza la temporada; los calendarios proporcionan tanto puntajes pasados como programación futura. Los detalles del partido incluyen campos granulares una vez que se completan los partidos.
Cuotas: Zyla utiliza suscripción + cuota. La primera API en una nueva cuenta generalmente incluye una prueba de 7 días o 50 solicitudes. Monitorea tu uso y consulta la página de la API para las opciones de acceso actuales.

Dónde explorar y próximos pasos

Navega por la lista de la API de NRL en Zyla: API de NRL. Zyla centraliza más de 10,000 APIs públicas, por lo que puedes agregar datos deportivos adicionales más tarde sin crear nuevas cuentas o manejar múltiples claves.

FAQ

Q: ¿Qué encabezado de autenticación requiere la API de NRL?
A: Usa Autorización: Bearer YOUR_API_KEY en cada solicitud a las URL de Zyla API Hub.

Q: ¿Qué parámetros son requeridos para cada endpoint?
A: La Clasificación requiere temporada. El Calendario requiere temporada y ronda. Los Detalles del Partido requieren match_id. Solo pasa esos parámetros de consulta documentados.

Q: ¿Puedo obtener temporadas históricas?
A: Sí. Los endpoints de Clasificación y Calendario soportan temporadas desde 2002, además del año actual.

Q: ¿Hay un plan gratuito?
A: No hay Plan Gratuito. La primera API en una nueva cuenta de Zyla generalmente incluye una prueba de 7 días o 50 solicitudes. Consulta la página de la API para las opciones de acceso actuales y precios.

Q: ¿Puedo llamar a la API desde un agente de IA?
A: Sí. Usa el endpoint MCP en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY. Tu agente puede entonces llamar a las mismas URL de la API de NRL.

¿Listo para enviar? Crea tu cuenta, suscríbete a la API de NRL y obtén tu clave aquí: Registrarse. Luego, integra los ejemplos de curl y JavaScript anteriores en tu aplicación y despliega tu clasificación de NRL, calendarios y centro de partidos esta semana.