Quem pode usá-la?
As ligas com o plano Gold que tenham ativado a API. Para a ativar, aceda a Início da administração > API > Definições da API e marque Ativar API JSON. Se faltar uma das duas condições, todos os endereços web destes artigos devolvem um erro em vez dos seus dados.
O que é?
A API permite que outro site, aplicação ou programa leia os calendários, os resultados e as classificações da sua liga diretamente a partir do LeagueRepublic. Pense nela como um empregado de mesa: o seu site pede algo («os jogos de hoje, por favor») e o LeagueRepublic traz a resposta.
Como se faz o pedido?
Visita um endereço web, tal como quando abre uma página web. Em vez de uma página bonita, recebe de volta 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 no que tiver desenhado.
Como é o 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). O que vem depois é o valor (o que foi escrito na caixa). A especificação da API explica o que significa cada nome de campo.
O que é um ID?
Cada liga, época, divisão, equipa e jogo no LeagueRepublic tem o seu próprio número, chamado ID. Funciona como um número de sócio: nunca muda e nunca há dois iguais. Coloca os IDs no endereço web para indicar qual a época ou a equipa que pretende.
Como encontro os meus IDs?
O ID da sua liga é apresentado em Início da administração > API > Definições da API.
O ID da sua época: abra este endereço no navegador, com o ID da sua liga no lugar de [MY-LEAGUE-ID]. Lista as suas épocas, cada uma com o respetivo ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Os IDs das divisões e das equipas aparecem nas listas que a API devolve. Se usar um dos artigos Criar… o assistente de IA procura-os por si.
Existe um limite?
Sim. Cada liga só pode fazer um certo número de pedidos por minuto, partilhado por tudo o que usa os dados da sua liga: o seu site, aplicações e qualquer outra coisa. 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.
Algumas palavras que vai encontrar
Road – a equipa visitante. O LeagueRepublic diz «road» onde a maioria das pessoas diz «fora».
Fixture – um jogo, quer já tenha sido disputado ou não.
Fixture group – uma divisão (como «Divisão de Honra»), uma taça ou outro grupo de jogos.
Result – um jogo que 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 detalhe completo?
Tudo o que é exato, como cada nome de campo, o limite e as mensagens de erro, está na especificação da API: