Nani anaweza kuitumia?
Ligi zilizo kwenye mpango wa Dhahabu (Gold) ambazo zimewasha API. Ili kuiwasha, nenda kwenye Ukurasa wa Mwanzo wa Msimamizi > API > Mipangilio ya API na uweke alama kwenye Washa JSON API. Ikiwa mojawapo haipo, kila anwani ya wavuti katika makala hizi itarudisha hitilafu badala ya data yako.
Ni nini?
API inaruhusu tovuti, programu au mfumo mwingine kusoma mechi, matokeo na majedwali ya ligi yako moja kwa moja kutoka LeagueRepublic. Ifikirie kama mhudumu wa mgahawa: tovuti yako inaomba kitu ("mechi za leo, tafadhali"), na LeagueRepublic inaleta jibu.
Unaombaje?
Unatembelea anwani ya wavuti, kama tu unavyofungua ukurasa wa wavuti. Badala ya ukurasa unaovutia, unapokea maandishi ya kawaida katika muundo unaoitwa JSON. Msimbo wa msanidi wako wa wavuti, au ukurasa uliotengenezwa na msaidizi wa AI, husoma maandishi hayo na kuyageuza kuwa chochote ulichobuni.
JSON inaonekanaje?
Ni orodha ya lebo na thamani, kama fomu iliyojazwa:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Neno lililo kabla ya nukta mbili ni jina la sehemu (lebo kwenye fomu). Kilicho baada yake ni thamani (kilichoandikwa kwenye kisanduku). Maelezo rasmi ya API yanaeleza maana ya kila jina la sehemu.
ID ni nini?
Kila ligi, msimu, daraja, timu na mechi katika LeagueRepublic ina namba yake, inayoitwa ID. Inafanya kazi kama namba ya uanachama: haibadiliki kamwe, na hakuna vitu viwili vinavyoshiriki moja. Unaweka ID kwenye anwani ya wavuti kuonyesha msimu au timu unayotaka.
Nitapataje ID zangu?
ID ya ligi yako inaonyeshwa kwenye Ukurasa wa Mwanzo wa Msimamizi > API > Mipangilio ya API.
ID ya msimu wako: fungua anwani hii kwenye kivinjari chako, ukiweka ID ya ligi yako mahali pa [ID-YA-LIGI-YANGU]. Inaorodhesha misimu yako, kila mmoja na ID yake.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-YA-LIGI-YANGU].json
ID za madaraja na timu zinaonekana kwenye orodha ambazo API inarudisha. Ukitumia mojawapo ya makala za Tengeneza…, msaidizi wa AI atazitafuta kwa niaba yako.
Je, kuna kikomo?
Ndiyo. Kila ligi inaweza kutuma idadi fulani tu ya maombi kwa dakika, ambayo inashirikiwa na kila kitu kinachotumia data ya ligi yako: tovuti yako, programu na kitu kingine chochote. Ukurasa uliotengenezwa vizuri huhifadhi kile unachopakia badala ya kuomba tena na tena. Maelezo rasmi ya API yanatoa kikomo kamili.
Maneno machache utakayoyaona
Road – timu ya ugenini. LeagueRepublic inasema "road" pale ambapo watu wengi husema "ugenini".
Mechi (fixture) – mchezo, iwe umeshachezwa au bado.
Kundi la mechi (fixture group) – daraja (kama vile "Premier Division"), kombe, au kundi jingine la mechi.
Matokeo (result) – mechi ambayo ina alama.
null – kisanduku ni tupu. Ligi haikukijaza, au hakihusiki.
true / false – ndiyo / hapana.
Maelezo kamili yako wapi?
Kila kitu kwa usahihi, kama kila jina la sehemu, kikomo na ujumbe wa hitilafu, kiko kwenye maelezo rasmi ya API: