Ką reiškia API? API naudojimo pavyzdžiai

Ką reiškia API? API naudojimo pavyzdžiai

API reiškia „Programų programavimo sąsaja“. Ir nors tai gali atrodyti keista, jei pradedate programuoti, juos lengva suprasti, kai tik jį sugadinsite. Jūs netgi naudojate juos kasdien, valdydami savo mobilųjį telefoną, kompiuterį ar naršydami internete.





Programinė įranga, įskaitant žiniatinklio programas, programas mobiliesiems ir daugelį kitų programų, sujungia pasaulį internetu. Tačiau norint, kad tai būtų efektyviau, tarp šios programinės įrangos turi būti ryšio kanalas - čia atsiranda API.





Čia paaiškinsime API reikšmę ir kaip jas naudoti.





Kas yra API?

Ar žinote, kaip galite matyti vaizdo įrašus srautinio perdavimo platformose, tokiose kaip „Netflix“ ir „YouTube“? Tai įmanoma, nes siunčiate užklausą per API.

Arba įsivaizdavote, kaip galite sumokėti už prekes, kurias perkate iš internetinių parduotuvių, tokių kaip „Amazon“ ir „eBay“? Taip yra ir todėl, kad tarp jūsų banko ir apsipirkimo programų yra ryšio kanalas, žinomas kaip API.



Be to, API yra sąsaja su taisyklių rinkiniu, leidžiančiu jūsų programos serveriui sąveikauti su sprendimų teikėjo serveriu, kad galėtumėte naudoti jų išteklius. Iš esmės tai apibrėžia, kaip programos ar programinė įranga bendrauja tarpusavyje.

Tačiau kai kuriais atvejais API leidžia keistis abipusiais duomenimis. Pavyzdys yra ryšys tarp jūsų banko programų ir internetinės parduotuvės programų.





API yra kaip pasiuntinys. Jis jungiasi prie teikėjo serverio viename gale ir taip pat įtvirtina kliento serverį kitame gale. Tada ji pateikia kliento užklausą duomenų šaltiniui (teikėjo serveriui) ir grąžina klientui atsakymą. Čia klientas yra naršyklė arba jūsų programa.

Tačiau kabliukas jūsų programą prikabina prie API. Tai yra API galutinis taškas. Tačiau užkulisiuose daug kas atsiskleidžia. Mes tai paaiškinsime toliau.





Kaip API padeda greičiau kurti programas

API yra protingesnis įrankis, skirtas kurti vientisas ir patikimas programas. Be jų, sudėtingų programų kūrimas užtruktų ilgai.

Įsivaizduokite, kad jūsų programai reikia sudėtingų operacijų, kurių sukūrimui reikia daug laiko ir pastangų. Ir tada kažkas pasirodo su paruošta programa, kuri daro būtent tai, ko norite, ir galbūt geriau.

kaip pradėti seriją sc

Bet kaip tai prijungti prie savo programos? Paslaugų teikėjas, supratęs, kad jums gali būti sunku, tada jums pasakė, kad sukūrė ryšio sąsają (API), leidžiančią sklandžiai integruoti jų ir jūsų kodą.

Ši sąsaja (API) jungiasi prie serverio, kuriame yra jų kodas. Tada jis grąžina jums svarbius duomenis iš jų scenarijaus veiksmo.

Žinoma, nenorite nuobodžiauti visu jų šaltinio scenarijumi. Be to, dauguma šiuolaikinių API dabar remiasi standartizuota REST (reprezentacinio valstybės perdavimo) technologija. Tai daro juos labai keičiamus ir lengvai integruojamus, jums nereikia jaudintis dėl to, kas vyksta jūsų viduje, ar jūsų atsakymo ar užklausos būsenos, kai jie yra iš anksto suformatuoti.

Šiame straipsnyje daugiau nebus paaiškinta REST API. Dabar sutelkite dėmesį į pagrindus.

Prijungti kodą prie jų yra geresnė mintis nei rašyti nuo nulio. Tačiau, norėdami tai padaryti, turite sujungti kodą su jų pateikta API. Kaip tai padaryti? Štai kur į sceną ateina API galinis taškas.

Kas yra API galinis taškas?

Kad būtų paprasčiau, paslaugų teikėjai sukuria URL, kad prisijungimas prie jų API būtų sklandus. Toks URL yra API galinis taškas . Tada programa gali pasiekti serverį per API ir tiesiogiai bendrauti su jų scenarijumi.

Taigi viskas, ką jums reikia padaryti, yra patraukti galutinį tašką, įklijuoti jį į savo kodą, pateikti su juo užklausas, tinkinti atsakymus, tada jis veikia ir yra jūsų! Todėl API galinis taškas susieja jūsų programą per API su sprendimu ar duomenų šaltiniu.

Galų gale daugelis programų, siūlančių API, yra prieinamos įvairiomis programavimo kalbomis, kad niekas nebūtų pašalintas iš jų naudos.

Tokiu būdu koduojate greičiau ir efektyviau, žinodami, kad API priežiūra tenka ne jums, o duomenims ar sprendimų teikėjams.

Todėl API galinis taškas yra ryšio kablys, jungiantis API prie išteklių serverio viename krašte ir jungiantis jį su imtuvo serveriu kitame gale.

Tai reiškia, kad jums nereikia viso norimo naudoti sprendimo scenarijaus. Tačiau jūsų kodas negali užmegzti ryšio su juo, jei jis neprisijungia prie savo API galinio taško.

API integravimo taisyklės

Nėra griežtos taisyklės, kaip integruoti API. Jų yra daugybė, ir kiekvienas iš jų turi savo integracijos taisykles. Tačiau atminkite, kad laukiatės atsakymas kai užmezgate ryšį su API.

Tai, kaip jūs teikiate užklausas naudodami API galinį tašką, paprastai grindžiamas teikėjo nustatytomis taisyklėmis, tačiau tai, ką darote atsakydami, priklauso nuo jūsų pageidavimų. Iš esmės galite ją pasukti taip, kaip norite, kad atitiktų jūsų programos naudotojų patirtį ir sąsają.

Kartais jums taip pat reikia autentifikatoriaus, kad galėtumėte pasiekti API. Tokie autentifikatoriai paprastai pateikiami kaip prieigos žetonai arba API raktai. Kai šis raktas išlaikys autentifikavimo testą, tada API signalizuoja savo galutinį tašką, kad užmegztų ryšį tarp jūsų programos ir teikėjo serverio.

Kadangi esate API vartotojas, jums nereikia nerimauti dėl šių parametrų, nes API teikėjas leidžia juos pasiekti. Puikioje API taip pat turėtų būti nurodyta, kaip galite pasiekti ir naudoti jos išteklius savo dokumentuose. Taigi visuomet atkreipkite dėmesį į tai, kai bandote jį integruoti.

Apibendrinant, API skambutis yra skirtas antraštes , an galutinis taškas , prašymas , ir atsakymas arba kūnas .

Nors paaiškinome, kas yra galutinis taškas, toliau suskaidykime šiuos kitus terminus:

Antraštės

Paprastai prisijungdami prie API turite aprašyti dvi antraščių formas: prašymas ir atsakymas antraštes.

The užklausos antraštė yra API skambučio vartai. Jame aprašomas kliento požiūris į prieigą prie išteklių. Jame gali būti išsami informacija, pvz., Priimtinas ryšio tipas, tarpinio serverio informacija ir duomenų tipas (JSON, XML arba HTML), kuriuos norite gauti iš API.

Kaip aprašėme anksčiau, priklausomai nuo API tipo, prie kurio jungiatės, gali tekti pateikti unikalų autentifikavimo raktą ir užklausos antraštėje. Paprastai tai teikia paslaugų teikėjas.

The atsakymo antraštė kita vertus, yra duomenų, gaunamų iš teikėjo serverio, tvirtinimas. Programoje pateikiama informacija apie teikėjo ypatybes. Iš esmės tai užtikrina, kad jūsų programa suteiks prieigą prie atsakymo, gaunamo iš API.

API užklausa

Paprastai API užklausoje galutinis taškas yra URL (unikalus išteklių ieškiklis). Jis naudoja hiperteksto perdavimo protokolą (HTTP), kad surastų ištekliaus, kurį bandote pasiekti naudodami API, adresą. Galiausiai API užklausa nėra baigta, jei į URL neįtraukiate galutinio taško.

prijungtas prie įkrovimo, bet neįkraunamas

API atsakymas

Atsakymas yra tai, ką API siunčia atgal kiekvieną kartą, kai gauna užklausą iš jūsų programos. Tai gali būti JSON, XML arba HTML, priklausomai nuo duomenų ar turinio tipo, kurį jie gauna iš jūsų užklausos antraštės.

Gavę atsakymą iš API, galite laikyti, kad jūsų API skambutis yra sėkmingas.

Kaip naudoti API: praktiniai pavyzdžiai

Dabar, kai žinote API pagrindus ir tai, ko reikia norint juos integruoti. Pažiūrėkite, kaip prijungti ir integruoti futbolo prognozavimo API iš RapidAPI naudojant Python žemiau.

Tai paprastas API skambutis, kuris grąžina JSON atsakymą. Taip pat galite parašyti kodą bet kuriame teksto redaktoriuje ir paleisti jį naudodami komandinę eilutę.

Susijęs: Kaip paleisti „Python“ scenarijų

Tačiau atkreipkite ypatingą dėmesį į galutinį tašką, užklausų antraščių ir atsakymų antraščių turinį:

import requests
endpoint = 'https://football-prediction-api.p.rapidapi.com/api/v2/predictions'
queryparams = {'market':'classic','iso_date':'2021-01-01','federation':'UEFA'}
#Define the request header:
headers = {
'x-rapidapi-key': 'Paste your access key here',
'x-rapidapi-host': 'football-prediction-api.p.rapidapi.com'
}
#Define the response header:
response = requests.request('GET', endpoint, headers=headers, params=queryparams)
#Get the response:
print(response.text)

Tęskite mokymąsi: kaip naudoti „IPStack“ API ieškant IP geografinės vietos

Kaip sužinoti dabartinę vietos temperatūrą ir drėgmę naudojant „Weatherstack“ API su Python? Štai pavyzdys žemiau:

import requests
endpoint = 'http://api.weatherstack.com/current'
headers = {
'access_key': 'Paste your access key here',
'query': 'California'
}
req = requests.get(endpoint, headers)
res = req.json()
print(u'Current temperature in %s is %d℃' %
(res['location']['name'], res['current']['temperature']))
print(u'Current humidity in %s is %d℃' %
(res['location']['name'], res['current']['humidity']))

API, kurias galite integruoti, tipai

Atvirojo kodo API yra nemokamos ir jomis gali naudotis visi. Vidinės API yra organizacijos viduje, o tik tos organizacijos programos gali naudoti jos išteklius.

Tačiau taip pat galite pasirinkti tam skirtą API, sudarydami partnerystės sutartį su teikėju. Arba galite sujungti kelias API, kad išspręstumėte įvairias problemas.

Be to, šios API, išskyrus atvirojo kodo ir vidines API, gali turėti savo kainą, kartais svyruojančią nuo šimtų iki tūkstančių dolerių.

Supaprastinkite programų kūrimą naudodami API

Kaip matote, jums nebereikia rašyti daug laiko reikalaujančio kodo. Jei jums reikia, kad jūsų programa atliktų sudėtingas operacijas, visada galite ieškoti ten ir paimti atitinkamą API. Laimei, juos dabar netgi lengva integruoti nei senus įprastus. O jei jums įdomu ir norite sužinoti daugiau, yra daug nemokamų API, kurios gali padėti jums susitepti rankas.

Dalintis Dalintis „Tweet“ Paštu Kaip veikia API ir kaip jas integruoti į savo programą

Programų sąsajų (API) naudojimas yra būtinas visų programuotojų įgūdis.

Skaityti toliau
Susijusios temos
  • Programavimas
  • Programavimas
  • UGNIS
  • Žargonas
  • Kodavimo patarimai
Apie autorių Idisou Omisola(Paskelbti 94 straipsniai)

Idowu aistringai domisi visomis išmaniosiomis technologijomis ir produktyvumu. Laisvalaikiu jis žaidžia koduodamasis ir nuobodžiai persijungia į šachmatų lentą, tačiau taip pat mėgsta retkarčiais atitrūkti nuo rutinos. Jo aistra parodyti žmonėms kelią aplink šiuolaikines technologijas skatina jį daugiau rašyti.

Daugiau iš Idowu Omisola

Prenumeruokite mūsų naujienlaiškį

Prisijunkite prie mūsų naujienlaiškio, kad gautumėte techninių patarimų, apžvalgų, nemokamų el. Knygų ir išskirtinių pasiūlymų!

Norėdami užsiprenumeruoti, spustelėkite čia