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, todos os endereços web destes artigos retornam um erro em vez dos seus dados.
O que é?
A API permite que outro site, aplicativo ou programa leia os jogos, resultados e tabelas da sua liga direto do LeagueRepublic. Pense nela como um garçom: seu site pede alguma coisa ("as partidas de hoje, por favor") e o LeagueRepublic traz a resposta.
Como fazer o pedido?
Você acessa um endereço web, do mesmo jeito que 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 uma página criada por um assistente de IA, lê esse texto e o transforma no que você projetar.
Como é o JSON?
É uma lista de rótulos e valores, mais ou menos 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). A parte depois é o valor (o que foi escrito no campo). A especificação da API explica o que significa cada nome de campo.
O que é um ID?
Cada liga, temporada, divisão, time e partida no LeagueRepublic tem um número próprio, chamado ID. Ele funciona como um número de sócio: nunca muda, e duas coisas nunca têm 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 [ID-DA-MINHA-LIGA]. Ele lista suas temporadas, cada uma com seu ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-DA-MINHA-LIGA].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 procura esses IDs para você.
Existe um limite?
Sim. Cada liga só pode fazer um certo número de solicitações por minuto, divididas entre 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).
Jogo (fixture) – uma partida, já disputada ou não.
Grupo de jogos (fixture group) – uma divisão (como "Premier Division"), uma copa ou outro grupo de partidas.
Resultado (result) – um jogo que tem placar.
null – o campo está vazio. 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: