Cine îl poate folosi?
Ligile cu planul Gold care au activat API-ul. Ca să-l activezi, mergi la Pagina principală de administrare > API > Setări API și bifează Activează API-ul JSON. Dacă lipsește oricare dintre ele, fiecare adresă web din aceste articole returnează o eroare în loc de datele tale.
Ce este?
API-ul permite unui alt site, unei aplicații sau unui program să citească meciurile, rezultatele și clasamentele ligii tale direct din LeagueRepublic. 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 ceri?
Accesezi o adresă web, exact ca atunci când deschizi o pagină. Î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 ce ai tu în plan.
Cum arată JSON?
Este o listă de etichete și valori, cam ca un formular completat:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Cuvântul dinaintea celor două puncte este numele câmpului (eticheta din formular). Partea de după este valoarea (ce s-a scris în căsuță). Specificația API 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 nu există două lucruri cu același număr. Pui ID-uri în adresa web ca să spui ce sezon sau ce echipă vrei.
Cum îmi găsesc ID-urile?
ID-ul ligii tale apare în Pagina principală de administrare > API > Setări API.
ID-ul sezonului tău: deschide această adresă în browser, punând ID-ul ligii tale în locul lui [ID-UL-LIGII-MELE]. Vei vedea lista sezoanelor tale, fiecare cu ID-ul lui.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-UL-LIGII-MELE].json
ID-urile diviziilor și 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, împărțit între tot ce folosește datele ligii tale: site-ul, aplicațiile și orice altceva. O pagină bine făcută păstrează ce a încărcat, în loc să ceară iar și iar. Specificația API indică limita exactă.
Câteva cuvinte pe care le vei întâlni
Road – echipa oaspete. LeagueRepublic spune „road” acolo unde majoritatea oamenilor spun „away” (în deplasare).
Meci (fixture) – un meci, fie că s-a jucat deja, fie că nu.
Grup de meciuri (fixture group) – o divizie (de exemplu „Premier Division”), o cupă sau alt grup de meciuri.
Rezultat (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?
Toate informațiile exacte, cum ar fi fiecare nume de câmp, limita și mesajele de eroare, se află în specificația API: