¿Quién puede usarla?
Las ligas con el plan Gold que hayan activado la API. Para activarla, ve a Inicio de administración > API > Configuración de la API y marca Activar API JSON. Si falta cualquiera de las dos cosas, todas las direcciones web de estos artículos devuelven un error en lugar de tus datos.
¿Qué es?
La API permite que otro sitio web, aplicación o programa lea los calendarios, los resultados y las clasificaciones de tu liga directamente desde LeagueRepublic. Piensa en ella como un camarero: tu sitio web pide algo («los partidos de hoy, por favor») y LeagueRepublic trae la respuesta.
¿Cómo se hace la petición?
Visitas una dirección web, igual que al abrir una página web. En lugar de una página bonita, recibes texto sin formato en un formato llamado JSON. El código de tu desarrollador web, o una página creada por un asistente de IA, lee ese texto y lo convierte en lo que hayas diseñado.
¿Qué aspecto tiene el JSON?
Es una lista de etiquetas y valores, un poco como un formulario que se ha rellenado:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
La palabra anterior a los dos puntos es el nombre del campo (la etiqueta del formulario). Lo que va después es el valor (lo que se escribió en la casilla). La especificación de la API explica qué significa cada nombre de campo.
¿Qué es un ID?
Cada liga, temporada, división, equipo y partido de LeagueRepublic tiene su propio número, llamado ID. Funciona como un número de socio: nunca cambia y no hay dos iguales. Pones los ID en la dirección web para indicar qué temporada o equipo quieres.
¿Cómo encuentro mis ID?
El ID de tu liga aparece en Inicio de administración > API > Configuración de la API.
El ID de tu temporada: abre esta dirección en tu navegador, con el ID de tu liga en lugar de [MY-LEAGUE-ID]. Enumera tus temporadas, cada una con su ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Los ID de división y de equipo aparecen en las listas que devuelve la API. Si usas uno de los artículos Crear… el asistente de IA los busca por ti.
¿Hay algún límite?
Sí. Cada liga solo puede hacer un cierto número de solicitudes por minuto, compartido por todo lo que usa los datos de tu liga: tu sitio web, aplicaciones y cualquier otra cosa. Una página bien hecha guarda lo que carga en lugar de pedir los mismos datos una y otra vez. La especificación de la API indica el límite exacto.
Algunas palabras que verás
Road – el equipo visitante. LeagueRepublic dice «road» donde la mayoría de la gente dice «fuera».
Fixture – un partido, ya se haya jugado o no.
Fixture group – una división (como «Primera División»), una copa u otro grupo de partidos.
Result – un partido que tiene marcador.
null – la casilla está vacía. La liga no la rellenó o no se aplica.
true / false – sí / no.
¿Dónde está el detalle completo?
Todo lo exacto, como cada nombre de campo, el límite y los mensajes de error, está en la especificación de la API: