Ruka hadi kwenye sehemu kuu

Jinsi API inavyofanya kazi

Makala hii inaeleza misingi ya API ya LeagueRepublic kwa lugha rahisi. Huhitaji ujuzi wowote wa kiufundi ili kuifuata.

Imeandikwa na Pedro Maia

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 kisha tia alama kwenye Washa JSON API. Ikiwa kimojawapo kati ya hivyo kinakosekana, kila anwani ya wavuti katika makala hizi hurudisha hitilafu badala ya data yako.

Ni nini?

API huruhusu tovuti, programu au programu-tumizi nyingine kusoma mechi, matokeo na majedwali ya ligi yako moja kwa moja kutoka LeagueRepublic. Ifikirie kama mhudumu wa mgahawa: tovuti yako huomba kitu („mechi za leo, tafadhali”), na LeagueRepublic hurudisha jibu.

Unaombaje?

Unatembelea anwani ya wavuti, kama vile unavyofungua ukurasa wa wavuti. Badala ya ukurasa mzuri, unapata maandishi matupu katika muundo unaoitwa JSON. Msimbo wa msanidi programu wako wa wavuti, au ukurasa uliotengenezwa na msaidizi wa AI, husoma maandishi hayo na kuyageuza kuwa chochote unachobuni.

JSON inaonekanaje?

Ni orodha ya lebo na thamani, kama fomu iliyojazwa:

{ "homeTeamName": "Arthurlie", "homeScore": "2" }

Neno lililo kabla ya nukta pacha ni jina la sehemu (lebo kwenye fomu). Kinachofuata baada yake ni thamani (kilichoandikwa kwenye kisanduku). Maelezo ya kiufundi ya API yanaeleza kila jina la sehemu linamaanisha nini.

ID ni nini?

Kila ligi, msimu, daraja, timu na mechi katika LeagueRepublic ina nambari yake, inayoitwa ID. Hufanya kazi kama nambari ya uanachama: haibadiliki kamwe, na hakuna vitu viwili vinavyoshiriki nambari moja. Unaweka ID kwenye anwani ya wavuti ili kusema unataka msimu au timu gani.

Nitazipataje 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 badala ya [MY-LEAGUE-ID]. Inaorodhesha misimu yako, kila mmoja na ID yake.

https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json

ID za daraja na timu huonekana kwenye orodha ambazo API hurudisha. Ikiwa unatumia mojawapo ya makala za Tengeneza…, msaidizi wa AI atazitafuta kwa ajili yako.

Je, kuna kikomo?

Ndiyo. Kila ligi inaweza kutuma idadi fulani tu ya maombi kwa dakika, inayogawanywa na kila kitu kinachotumia data ya ligi yako: tovuti yako, programu na kingine chochote. Ukurasa uliotengenezwa vizuri huhifadhi unachopakia badala ya kuomba tena na tena. Kikomo kamili kimetajwa kwenye maelezo ya kiufundi ya API.

Maneno machache utakayoyaona

Road – timu ya ugenini. LeagueRepublic husema „road” mahali ambapo watu wengi husema „away”.

Fixture – mechi, iwe imechezwa tayari au bado.

Fixture group – daraja (kama „Premier Division”), kombe, au kundi jingine la mechi.

Result – mechi iliyo na matokeo.

null – kisanduku ni tupu. Ligi haikukijaza, au hakihusiki.

true / false – ndiyo / hapana.

Maelezo kamili yako wapi?

Kila kitu kamili, kama kila jina la sehemu, kikomo na ujumbe wa hitilafu, kiko kwenye maelezo ya kiufundi ya API:

Je, hili lilikuwa jibu la swali lako?