Ki használhatja?
Azok a Gold csomagos bajnokságok, amelyek bekapcsolták az API-t. A bekapcsoláshoz lépjen az Admin kezdőlap > API > API-beállítások oldalra, és pipálja be a JSON API engedélyezése jelölőnégyzetet. Ha bármelyik hiányzik, az ezekben a cikkekben szereplő összes webcím az adatai helyett hibát ad vissza.
Mi ez?
Az API lehetővé teszi, hogy egy másik weboldal, alkalmazás vagy program közvetlenül a LeagueRepublicból olvassa ki a bajnokság mérkőzéseit, eredményeit és tabelláit. Képzelje el pincérként: a weboldala kér valamit ("a mai mérkőzéseket, kérem"), a LeagueRepublic pedig hozza a választ.
Hogyan kérjük?
Megnyit egy webcímet, éppen úgy, mint egy weboldalt. Szépen kinéző oldal helyett egyszerű szöveget kap JSON nevű formátumban. A webfejlesztő 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 (az űrlapon a címke). 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, ezt hívjuk azonosítónak (ID). Úgy működik, mint egy tagsági szám: soha nem változik, és két dolognak nincs ugyanaz. Az azonosítókat a webcímbe írja be, hogy megmondja, melyik szezont vagy csapatot kéri.
Hogyan találom meg az azonosítóimat?
A bajnokság azonosítója az Admin 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, a [MY-LEAGUE-ID] helyére a bajnokság azonosítóját írva. Felsorolja a szezonjait, mindegyiket az azonosítójával.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
Az osztályok és csapatok azonosítói az API által visszaküldött listákban szerepelnek. Ha valamelyik Készítsen… 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 weboldal, az alkalmazások és bármi 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 "road" szót mond ott, ahol a legtöbben "away" (vendég) szót használnak.
Fixture – egy mérkőzés, akár lejátszották már, akár nem.
Fixture group – egy osztály (például "Premier Division"), egy kupa vagy mérkőzések másik csoportja.
Result – olyan mérkőzés, amelynek van eredménye.
null – a mező üres. A bajnokság nem adta meg, vagy nem vonatkozik rá.
true / false – igen / nem.
Hol találom a teljes leírást?
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: