Chi può usarla?
Le leghe con il piano Oro che hanno attivato l'API. Per attivarla, vai su Home amministratore > API > Impostazioni API e seleziona Abilita API JSON. Se manca una di queste due cose, ogni indirizzo web di questi articoli restituisce un errore invece dei tuoi dati.
Che cos'è?
L'API permette a un altro sito web, a un'app o a un 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 una richiesta?
Visiti un indirizzo web, proprio come quando apri una pagina web. Invece di una pagina dall'aspetto curato, ricevi del testo semplice in un formato chiamato JSON. Il codice del tuo sviluppatore web, o una pagina creata da un assistente IA, legge quel testo e lo trasforma in quello 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 non esistono due elementi con lo stesso ID. Inserisci gli ID nell'indirizzo web per indicare quale stagione o squadra vuoi.
Come trovo i miei ID?
L'ID della tua lega è indicato in Home amministratore > API > Impostazioni API.
L'ID della tua stagione: apri questo indirizzo nel browser, mettendo l'ID della tua lega al posto di [ID-DELLA-MIA-LEGA]. Elenca le tue stagioni, ognuna con il proprio ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-DELLA-MIA-LEGA].json
Gli ID delle divisioni e delle squadre compaiono negli elenchi che l'API restituisce. Se usi uno degli articoli Crea…, l'assistente IA li cerca per te.
C'è un limite?
Sì. Ogni lega può fare 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 più e più volte. La specifica dell'API indica il limite esatto.
Alcune parole che incontrerai
Road – la squadra in trasferta. LeagueRepublic dice "road" dove la maggior parte delle persone direbbe "away" (fuori casa).
Partita (fixture) – un incontro, che sia già stato giocato o no.
Gruppo di partite (fixture group) – una divisione (come "Premier Division"), una coppa o un altro gruppo di partite.
Risultato – 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: