Kas to var izmantot?
Līgas ar Zelta plānu, kurām ir ieslēgts API. Lai to ieslēgtu, atveriet Administratora sākums > API > API iestatījumi un atzīmējiet Iespējot JSON API. Ja kāda no šīm lietām trūkst, katra šajos rakstos minētā tīmekļa adrese jūsu datu vietā atgriezīs kļūdu.
Kas tas ir?
API ļauj citai vietnei, lietotnei vai programmai nolasīt jūsu līgas spēles, rezultātus un tabulas tieši no LeagueRepublic. Iedomājieties to kā viesmīli: jūsu vietne kaut ko palūdz („šodienas spēles, lūdzu“), un LeagueRepublic atnes atbildi.
Kā pieprasīt datus?
Jūs atverat tīmekļa adresi tieši tāpat kā tīmekļa lapu. Skaisti noformētas lapas vietā jūs saņemat vienkāršu tekstu formātā, ko sauc par JSON. Jūsu tīmekļa izstrādātāja kods vai MI asistenta izveidota lapa nolasa šo tekstu un pārvērš to par jebko, ko esat izdomājis.
Kā izskatās JSON?
Tas ir etiķešu un vērtību saraksts, mazliet līdzīgs aizpildītai veidlapai:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Vārds pirms kola ir lauka nosaukums (etiķete veidlapā). Daļa aiz tā ir vērtība (tas, kas ierakstīts lodziņā). API specifikācijā ir paskaidrots, ko nozīmē katrs lauka nosaukums.
Kas ir ID?
Katrai LeagueRepublic līgai, sezonai, divīzijai, komandai un spēlei ir savs numurs, ko sauc par ID. Tas darbojas kā biedra numurs: tas nekad nemainās, un divām lietām nevar būt viens un tas pats. ID jūs ievietojat tīmekļa adresē, lai norādītu, kuru sezonu vai komandu vēlaties.
Kā atrast savus ID?
Jūsu līgas ID ir redzams sadaļā Administratora sākums > API > API iestatījumi.
Jūsu sezonas ID: atveriet šo adresi pārlūkprogrammā, [MANAS-LĪGAS-ID] vietā ierakstot savas līgas ID. Tiks parādīts jūsu sezonu saraksts, katra ar savu ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MANAS-LĪGAS-ID].json
Divīziju un komandu ID ir redzami sarakstos, ko atgriež API. Ja izmantojat kādu no rakstiem Izveidojiet…, MI asistents tos atradīs jūsu vietā.
Vai ir ierobežojums?
Jā. Katra līga minūtē var veikt tikai noteiktu skaitu pieprasījumu, un šo skaitu dala viss, kas izmanto jūsu līgas datus: jūsu vietne, lietotnes un viss pārējais. Labi veidota lapa saglabā ielādēto, nevis prasa to atkal un atkal. Precīzs ierobežojums ir norādīts API specifikācijā.
Daži vārdi, ko redzēsiet
Road – viesu komanda. LeagueRepublic saka „road“ tur, kur lielākā daļa cilvēku saka „away“ (izbraukumā).
Spēle (fixture) – mačs neatkarīgi no tā, vai tas jau ir aizvadīts vai ne.
Spēļu grupa (fixture group) – divīzija (piemēram, „Premier Division“), kauss vai cita spēļu grupa.
Rezultāts – spēle, kurai ir rezultāts.
null – lodziņš ir tukšs. Līga to nav aizpildījusi, vai arī tas nav attiecināms.
true / false – jā / nē.
Kur atrast visu informāciju?
Visa precīzā informācija, piemēram, katrs lauka nosaukums, ierobežojums un kļūdu ziņojumi, ir API specifikācijā: