Cine îl poate folosi?
Ligile cu planul Gold care au activat API-ul. Pentru a-l activa, mergi la Pagina principală de administrare > API > Setări API și bifează Activează API-ul JSON. Dacă una dintre cele două lipsește, toate adresele web din aceste articole returnează o eroare în loc de datele tale.
Ce este?
API-ul permite altui site web, altei aplicații sau altui program să citească direct din LeagueRepublic meciurile programate, rezultatele și clasamentele ligii tale. Gândește-te la el ca la un ospătar: site-ul tău cere ceva („meciurile de azi, te rog”), iar LeagueRepublic aduce răspunsul.
Cum soliciți datele?
Accesezi o adresă web, exact ca atunci când deschizi o pagină web. În loc de o pagină frumoasă, primești text simplu într-un format numit JSON. Codul dezvoltatorului tău web sau o pagină creată de un asistent AI citește acel text și îl transformă în orice design îți dorești.
Cum arată JSON?
Este o listă de etichete și valori, cam ca un formular completat:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Cuvântul dinaintea semnului două puncte este numele câmpului (eticheta din formular). Ce urmează după el este valoarea (ce a fost scris în căsuță). Specificația API-ului explică ce înseamnă fiecare nume de câmp.
Ce este un ID?
Fiecare ligă, sezon, divizie, echipă și meci din LeagueRepublic are propriul număr, numit ID. Funcționează ca un număr de membru: nu se schimbă niciodată și două lucruri nu au același număr. Pui ID-urile în adresa web pentru a spune ce sezon sau ce echipă vrei.
Cum îmi găsesc ID-urile?
ID-ul ligii tale este afișat în Pagina principală de administrare > API > Setări API.
ID-ul sezonului: deschide această adresă în browser, cu ID-ul ligii tale în locul lui [MY-LEAGUE-ID]. Ea listează sezoanele tale, fiecare cu ID-ul său.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID-urile diviziilor și ale echipelor apar în listele pe care le trimite API-ul. Dacă folosești unul dintre articolele Creează…, asistentul AI le caută pentru tine.
Există o limită?
Da. Fiecare ligă poate face doar un anumit număr de cereri pe minut, partajat între tot ce folosește datele ligii tale: site-ul, aplicațiile și orice altceva. O pagină bine făcută salvează ce a încărcat, în loc să ceară aceleași date iar și iar. Limita exactă este indicată în specificația API-ului.
Câteva cuvinte pe care le vei întâlni
Road – echipa oaspete. LeagueRepublic spune „road” acolo unde majoritatea oamenilor spun „away”.
Fixture – un meci, indiferent dacă a fost jucat sau nu.
Fixture group – o divizie (de exemplu „Premier Division”), o cupă sau un alt grup de meciuri.
Result – un meci care are scor.
null – căsuța este goală. Liga nu a completat-o sau nu se aplică.
true / false – da / nu.
Unde găsesc toate detaliile?
Tot ce este exact, cum ar fi fiecare nume de câmp, limita și mesajele de eroare, se află în specificația API-ului: