¿Quién puede usarla?
Las ligas con el plan Oro 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 partidos, resultados y 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 le trae la respuesta.
¿Cómo se hace una petición?
Visitas una dirección web, igual que cuando abres una página web. En lugar de una página con buen aspecto, recibes texto plano 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, algo así como un formulario rellenado:
{ "homeTeamName": "Arthurlie", "homeScore": "2" }
La palabra antes de 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 en LeagueRepublic tiene su propio número, llamado ID. Funciona como un número de socio: nunca cambia y no hay dos elementos que compartan el mismo. Pones los IDs en la dirección web para indicar qué temporada o equipo quieres.
¿Cómo encuentro mis IDs?
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, sustituyendo [ID-DE-MI-LIGA] por el ID de tu liga. Aparece una lista de tus temporadas, cada una con su ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-DE-MI-LIGA].jsonLos IDs de las divisiones y los equipos 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 número determinado de peticiones 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.
Algunos términos que verás
Road – el equipo visitante. LeagueRepublic usa "road" donde la mayoría de la gente diría "away".
Fixture – un partido, se haya jugado ya o no.
Fixture group – una división (como la "Primera División"), una copa u otro grupo de partidos.
Result – un partido que ya tiene resultado.
null – la casilla está vacía. La liga no la rellenó o no se aplica.
true / false – sí / no.
¿Dónde está toda la información detallada?
Toda la información exacta, como cada nombre de campo, el límite y los mensajes de error, está en la especificación de la API:
https://docs.api.leaguerepublic.com/leaguerepublic-read-api.html