Ki használhatja?
A Gold tervvel rendelkező bajnokságok, amelyek bekapcsolták az API-t. A bekapcsoláshoz lépjen az Adminisztrátori kezdőlap > API > API-beállítások menüpontra, és jelölje be az JSON API engedélyezése lehetőséget. Ha bármelyik hiányzik, a cikkekben szereplő összes webcím hibát ad vissza az adatai helyett.
Mi ez?
Az API lehetővé teszi, hogy egy másik webhely, alkalmazás vagy program közvetlenül a LeagueRepublicból olvassa be bajnoksága mérkőzéseit, eredményeit és tabelláit. Képzelje el úgy, mint egy pincért: a webhelye kér valamit („a mai mérkőzéseket, legyen szíves”), a LeagueRepublic pedig visszahozza a választ.
Hogyan lehet kérni valamit?
Megnyit egy webcímet, pont úgy, mint egy weboldalt. Szépen formázott oldal helyett azonban egyszerű szöveget kap vissza, JSON nevű formátumban. A webfejlesztője kódja vagy egy MI-asszisztens által készített oldal beolvassa ezt a szöveget, és azzá alakítja, amit megtervezett.
Hogyan néz ki a JSON?
Címkék és értékek listája, kicsit olyan, mint egy kitöltött űrlap:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
A kettőspont előtti szó a mezőnév (a címke az űrlapon). Az utána következő rész az érték (amit a mezőbe írtak). Az API-specifikáció elmagyarázza, mit jelent az egyes mezőnév.
Mi az az azonosító (ID)?
A LeagueRepublicban minden bajnokságnak, szezonnak, osztálynak, csapatnak és mérkőzésnek saját száma van, amelyet azonosítónak (ID) nevezünk. Úgy működik, mint egy tagsági szám: soha nem változik, és két dolognak nem lehet ugyanaz. Az azonosítókat a webcímbe írva adja meg, melyik szezont vagy csapatot szeretné.
Hogyan találom meg az azonosítóimat?
A bajnokság azonosítója az Adminisztrátori kezdőlap > API > API-beállítások oldalon látható.
A szezon azonosítója: nyissa meg ezt a címet a böngészőjében úgy, hogy a [BAJNOKSÁGOM-AZONOSÍTÓJA] helyére a bajnokság azonosítóját írja. Ez felsorolja a szezonjait, mindegyiket a saját azonosítójával.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[BAJNOKSÁGOM-AZONOSÍTÓJA].json
Az osztályok és csapatok azonosítói az API által visszaküldött listákban szerepelnek. Ha valamelyik … készítése cikket használja, az MI-asszisztens megkeresi ezeket Ön helyett.
Van korlát?
Igen. Minden bajnokság percenként csak bizonyos számú kérést küldhet, és ezen osztozik minden, ami a bajnokság adatait használja: a webhelye, az alkalmazások és minden más. Egy jól elkészített oldal elmenti, amit betöltött, ahelyett hogy újra és újra lekérné. A pontos korlátot az API-specifikáció tartalmazza.
Néhány szó, amellyel találkozni fog
Road – a vendégcsapat. A LeagueRepublic a „road” szót használja ott, ahol a legtöbben az „away” (idegenben) szót mondanák.
Mérkőzés (fixture) – egy meccs, akár lejátszották már, akár nem.
Mérkőzéscsoport (fixture group) – egy osztály (például „Premier Division”), egy kupa vagy a mérkőzések más csoportja.
Eredmény – olyan mérkőzés, amelynek van eredménye.
null – a mező üres. A bajnokság nem töltötte ki, vagy nem vonatkozik rá.
true / false – igen / nem.
Hol találom a részleteket?
Minden pontos részlet, például az összes mezőnév, a korlát és a hibaüzenetek, megtalálható az API-specifikációban: