Quem a pode utilizar?
As ligas com o plano Ouro que tenham ativado a API. Para a ativar, aceda a Início da Administração > API > Definições da API e assinale Ativar API JSON. Se faltar alguma destas condições, todos os endereços web indicados nestes artigos devolvem um erro em vez dos seus dados.
O que é?
A API permite que outro website, aplicação ou programa leia os jogos, resultados e classificações da sua liga diretamente a partir da LeagueRepublic. Pense nela como um empregado de mesa: o seu website pede algo ("os jogos de hoje, por favor") e a LeagueRepublic traz a resposta.
Como se faz um pedido?
Visita um endereço web, tal como quando abre uma página web. Em vez de uma página com bom aspeto, recebe texto simples num formato chamado JSON. O código do seu programador web, ou uma página criada por um assistente de IA, lê esse texto e transforma-o naquilo que tiver idealizado.
Qual é o aspeto do JSON?
É uma lista de etiquetas e valores, um pouco como um formulário preenchido:
{ "homeTeamName": "Arthurlie", "homeScore": "2" }
A palavra antes dos dois pontos é o nome do campo (a etiqueta do formulário). A parte a seguir é o valor (o que foi escrito na caixa). A especificação da API explica o significado de cada nome de campo.
O que é um ID?
Cada liga, época, divisão, equipa e jogo na LeagueRepublic tem o seu próprio número, chamado ID. Funciona como um número de sócio: nunca muda e não há dois elementos com o mesmo. Coloca os IDs no endereço web para indicar que época ou equipa pretende.
Como encontro os meus IDs?
O ID da sua liga aparece em Início da Administração > API > Definições da API.
O ID da sua época: abra este endereço no seu navegador, substituindo [ID-DA-MINHA-LIGA] pelo ID da sua liga. Aparece uma lista das suas épocas, cada uma com o respetivo ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-DA-MINHA-LIGA].jsonOs IDs das divisões e das equipas aparecem nas listas que a API devolve. Se utilizar um dos artigos "Criar…", o assistente de IA procura-os por si.
Existe algum limite?
Sim. Cada liga só pode fazer um determinado número de pedidos por minuto, partilhado por tudo o que utiliza os dados da sua liga: o seu website, aplicações e tudo o resto. Uma página bem feita guarda o que carrega em vez de pedir os mesmos dados repetidamente. A especificação da API indica o limite exato.
Alguns termos que vai encontrar
Road – a equipa visitante. A LeagueRepublic usa "road" onde a maioria das pessoas diria "away".
Fixture – um jogo, quer já tenha sido disputado quer não.
Fixture group – uma divisão (como a "Primeira Divisão"), uma taça ou outro grupo de jogos.
Result – um jogo que já tem resultado.
null – a caixa está vazia. A liga não a preencheu ou não se aplica.
true / false – sim / não.
Onde estão todos os detalhes?
Toda a informação exata, como cada nome de campo, o limite e as mensagens de erro, está na especificação da API:
https://docs.api.leaguerepublic.com/leaguerepublic-read-api.html