Chi può usarla?
Le leghe con il piano Gold che hanno attivato l'API. Per attivarla, vai su Home amministratore > API > Impostazioni API e spunta Abilita API JSON. Se manca una delle due cose, ogni indirizzo web in questi articoli restituisce un errore invece dei tuoi dati.
Che cos'è?
L'API permette a un altro sito web, app o programma di leggere le partite, i risultati e le classifiche della tua lega direttamente da LeagueRepublic. Pensala come un cameriere: il tuo sito web chiede qualcosa ("le partite di oggi, per favore") e LeagueRepublic porta la risposta.
Come si fa la richiesta?
Visiti un indirizzo web, proprio come quando apri una pagina web. Invece di una pagina dall'aspetto curato, ricevi testo semplice in un formato chiamato JSON. Il codice del tuo sviluppatore web, o una pagina creata da un assistente AI, legge quel testo e lo trasforma in ciò che hai progettato.
Che aspetto ha il JSON?
È un elenco di etichette e valori, un po' come un modulo compilato:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
La parola prima dei due punti è il nome del campo (l'etichetta sul modulo). La parte dopo è il valore (quello che è stato scritto nella casella). La specifica dell'API spiega il significato di ogni nome di campo.
Che cos'è un ID?
Ogni lega, stagione, divisione, squadra e partita in LeagueRepublic ha un proprio numero, chiamato ID. Funziona come un numero di tessera: non cambia mai e due elementi non ne condividono uno. Inserisci gli ID nell'indirizzo web per indicare quale stagione o squadra vuoi.
Come trovo i miei ID?
L'ID della tua lega è mostrato in Home amministratore > API > Impostazioni API.
L'ID della tua stagione: apri questo indirizzo nel browser, con l'ID della tua lega al posto di [MY-LEAGUE-ID]. Elenca le tue stagioni, ciascuna con il suo ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Gli ID di divisioni e squadre compaiono negli elenchi che l'API restituisce. Se usi uno degli articoli Crea…, l'assistente AI li cerca per te.
C'è un limite?
Sì. Ogni lega può inviare solo un certo numero di richieste al minuto, condiviso da tutto ciò che usa i dati della tua lega: il tuo sito web, le app e qualsiasi altra cosa. Una pagina fatta bene salva ciò che carica invece di chiederlo ancora e ancora. Il limite esatto è indicato nella specifica dell'API.
Alcune parole che incontrerai
Road – la squadra ospite. LeagueRepublic dice "road" dove la maggior parte delle persone dice "away" (ospite).
Fixture – una partita, che sia già stata giocata oppure no.
Fixture group – una divisione (come "Premier Division"), una coppa o un altro gruppo di partite.
Result – una partita che ha un punteggio.
null – la casella è vuota. La lega non l'ha compilata, oppure non è applicabile.
true / false – sì / no.
Dove trovo tutti i dettagli?
Tutti i dettagli precisi, come ogni nome di campo, il limite e i messaggi di errore, si trovano nella specifica dell'API: