Quem pode usar?
Ligas no plano Gold que ativaram a API. Para ativá-la, vá em Início do administrador > API > Configurações da API e marque Ativar API JSON. Se faltar qualquer uma das duas coisas, todo endereço web destes artigos retorna um erro em vez dos seus dados.
O que é?
A API permite que outro site, aplicativo ou programa leia as partidas, os resultados e as tabelas da sua liga direto do LeagueRepublic. Pense nela como um garçom: seu site pede algo ("as partidas de hoje, por favor") e o LeagueRepublic traz a resposta.
Como pedir?
Você acessa um endereço web, como quando abre uma página. Em vez de uma página bonita, você recebe texto simples em um formato chamado JSON. O código do seu desenvolvedor web, ou de uma página feita por um assistente de IA, lê esse texto e o transforma no que você projetou.
Como é o JSON?
É uma lista de rótulos e valores, um pouco como um formulário preenchido:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
A palavra antes dos dois-pontos é o nome do campo (o rótulo do formulário). O que vem depois é o valor (o que foi escrito na caixa). A especificação da API explica o que cada nome de campo significa.
O que é um ID?
Cada liga, temporada, divisão, time e partida no LeagueRepublic tem o seu próprio número, chamado ID. Ele funciona como um número de sócio: nunca muda, e duas coisas nunca compartilham o mesmo. Você coloca IDs no endereço web para dizer qual temporada ou time você quer.
Como encontro meus IDs?
O ID da sua liga aparece em Início do administrador > API > Configurações da API.
O ID da sua temporada: abra este endereço no navegador, colocando o ID da sua liga no lugar de [MY-LEAGUE-ID]. Ele lista as suas temporadas, cada uma com o seu ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Os IDs de divisões e times aparecem nas listas que a API devolve. Se você usar um dos artigos Crie…, o assistente de IA busca esses IDs para você.
Existe um limite?
Sim. Cada liga só pode fazer um certo número de requisições por minuto, compartilhado por tudo o que usa os dados da sua liga: seu site, aplicativos e qualquer outra coisa. Uma página bem feita guarda o que carrega em vez de pedir de novo e de novo. A especificação da API informa o limite exato.
Algumas palavras que você vai ver
Road – o time visitante. O LeagueRepublic diz "road" onde a maioria das pessoas diz "away" (fora de casa).
Fixture – uma partida, tenha ela sido jogada ou não.
Fixture group – uma divisão (como "Premier Division"), uma copa ou outro grupo de partidas.
Result – uma fixture que tem placar.
null – a caixa está vazia. A liga não preencheu, ou não se aplica.
true / false – sim / não.
Onde estão todos os detalhes?
Tudo o que é exato, como cada nome de campo, o limite e as mensagens de erro, está na especificação da API: