Kaj pomeni API? Primeri uporabe API-jev

API pomeni "Vmesnik za programiranje aplikacij". In čeprav se to morda sliši nenavadno, če ste nov v programiranju, jih je enostavno razumeti, ko ga razčlenite. Uporabljate jih celo vsak dan, ko uporabljate mobilni telefon, računalnik ali brskate po internetu.

Programska oprema, vključno s spletnimi aplikacijami, mobilnimi aplikacijami in številnimi drugimi programi, povezuje svet prek interneta. Da pa bi bilo to bolj učinkovito, mora obstajati komunikacijski kanal med to programsko opremo - tu pride API.

Tukaj bomo razložili pomen API-jev in kako jih uporabiti.

Kaj je API?

Ali veste, kako si lahko med drugim ogledate videoposnetke na pretočnih platformah, kot sta Netflix in YouTube? Možno je, ker zahtevo pošiljate prek API-ja.

Ali ste si predstavljali, kako lahko plačate za blago, ki ga kupujete v spletnih trgovinah, kot sta Amazon in eBay? To je tudi zato, ker med vašo banko in nakupovalnimi aplikacijami obstaja komunikacijski kanal, znan kot API.

Kljub temu je API vmesnik s sklopom pravil, ki strežniku aplikacije omogočajo interakcijo s strežnikom ponudnika rešitev, tako da lahko uporabljate njihove vire. V bistvu določa, kako aplikacije ali programska oprema komunicirajo med seboj.

V nekaterih primerih pa API omogoča vzajemno izmenjavo podatkov. Primer je povezava, ki obstaja med vašimi bančnimi aplikacijami in aplikacijami spletne trgovine.

API je kot sel. Na enem koncu se poveže s strežnikom ponudnika, na drugem pa tudi sidra odjemalčev strežnik. Nato naročnikovo zahtevo odda v vir podatkov (strežnik ponudnika) in stranki vrne odgovor. Tu je odjemalec brskalnik ali vaša aplikacija.

Kljuka pa vašo aplikacijo pritrdi na API. To je končna točka API-ja. Vendar se veliko stvari odvija v ozadju. Te bomo razložili še naprej.

Kako vam API-ji pomagajo hitreje razvijati aplikacije

API-ji so pametnejše orodje za izdelavo brezhibnih in robustnih aplikacij. Brez njih bi gradnja dovršenih aplikacij trajala dolgo.

Predstavljajte si, da potrebujete svojo aplikacijo za izvajanje zapletenih operacij, za oblikovanje katerih je treba veliko časa in truda. In potem se prikaže nekdo s pripravljenim programom, ki naredi točno tisto, kar želite, in morda tudi bolje.

Kako pa lahko to povežete s svojo aplikacijo? Ponudnik, ki se je zavedel, da vam to morda oteži, je nato povedal, da so ustvarili povezovalni vmesnik (API), zaradi katerega se njihova in vaša koda nemoteno integrirata.

Ta vmesnik (API) se poveže s strežnikom, ki vsebuje njihovo kodo. Nato vam pošlje nazaj ustrezne podatke iz dejanja njihovega skripta.

Seveda se ne želite dolgočasiti s celotnim izvornim skriptom. Poleg tega se večina sodobnih API-jev zdaj opira na standardizirano tehnologijo REST (Representational State Transfer). Zaradi njih so zelo prilagodljivi in ​​enostavni za integracijo, ne da bi vam bilo treba skrbeti, kaj se dogaja znotraj, ali stanje vašega odgovora ali zahteve, ko so predhodno oblikovani.

Ta članek ne bo nadaljeval z razlago API-ja REST. Zaenkrat se osredotočite na osnove.

Priključitev kode na njihovo je boljša ideja kot pisanje iz nič. Za to pa morate svojo kodo povezati z API-jem, ki so ga zagotovili. Kako to naredite? Tu nastopi končna točka API.

Kaj je končna točka API-ja?

Da bi poenostavili stvari, ponudniki nato pripravijo URL, s katerim omogočijo brezhibno povezavo s svojim API-jem. Takšen URL je Končna točka API. Z njim lahko vaša aplikacija nato prek API-ja dostopa do svojega strežnika in neposredno komunicira s svojim skriptom.

Torej vse, kar morate storiti, je, da zgrabite končno točko, jo prilepite v svojo kodo, z njo pošljete zahteve, prilagodite odzive in potem deluje in je vaša! Končna točka API-ja zato aplikacijo prek API-ja veže na rešitev ali vir podatkov.

Končno je veliko programov, ki ponujajo API-je, na voljo v različnih programskih jezikih, tako da nihče ne bo izključen iz njih.

Na ta način kodirate hitreje in učinkoviteje, saj veste, da vzdrževanje API-ja ni na vas, temveč na ponudnike podatkov ali rešitev.

Zato je končna točka API komunikacijski kavelj, ki API veže na strežnik virov na enem robu in ga poveže s strežnikom sprejemnika na drugem koncu.

To pomeni, da ne potrebujete celotnega skripta rešitve, ki jo želite uporabiti. Toda vaša koda ne more vzpostaviti komunikacije z njo, če se ne poveže s svojo končno točko API.

Pravila za integracijo API-ja

Za integracijo API-ja ni trdega pravila. Zunaj jih je na tone in vsak ima svoja pravila integracije. Toda ne pozabite, da pričakujete odziv vsakič, ko vzpostavite povezavo z API-jem.

Kako pošiljate zahteve prek končne točke API-ja, običajno temelji na pravilih, ki jih določi ponudnik, toda kaj boste storili z odzivom, ki ga dobite, je odvisno od vaše želje. V bistvu ga lahko zasukate, ko se želite prilagoditi uporabniški izkušnji in vmesniku aplikacije.

Včasih potrebujete tudi overitelj, preden lahko dostopate do API-ja. Takšni overitelji so ponavadi v obliki žetonov za dostop ali ključev API. Ko ta žeton opravi preizkus preverjanja pristnosti, API nato sporoči svojo končno točko, da vzpostavi povezavo med vašo aplikacijo in strežnikom ponudnika.

Kot potrošnik API vam ni treba skrbeti za te parametre, ker jih ponuja ponudnik API. Odličen API mora v svoji dokumentaciji navesti tudi, kako lahko dostopate do njegovih virov in jih uporabljate. Zato vedno bodite pozorni na to, ko ga poskušate integrirati.

Če ga želite zaokrožiti, je klic API vse okoli glave, an končna točka, prošnja, in odziv ali telo.

Medtem ko smo razložili, kaj je končna točka, razčlenimo še te pogoje:

Glave

Običajno morate med povezovanjem z API opisati dve obliki naslovov: prošnja in odziv glave.

The glava zahteve je prehod klica API. Opisuje pristop stranke do dostopa do vira. V njem so lahko podrobno opisane stvari, kot so sprejemljiva vrsta povezave, informacije o strežniku proxy in podatkovni tip (JSON, XML ali HTML), ki ga želite dobiti iz API-ja.

Kot smo že opisali, boste morda morali v glavi zahteve vnesti tudi edinstven žeton za preverjanje pristnosti, odvisno od vrste API-ja, s katerim se povezujete. Ponudnik to običajno da.

The glava odzivapo drugi strani pa je trditev o podatkih, ki prihajajo s strežnika ponudnika. Daje vaši aplikaciji informacije o značilnostih ponudnika. V bistvu zagotavlja, da vaša aplikacija dovoli dostop do odgovora, ki prihaja iz API-ja.

Zahteva za API

Zahteva za API običajno vsebuje končno točko v URL-ju (Unique Resource Locator). Uporablja protokol za prenos hiperteksta (HTTP) za iskanje naslova vira, do katerega želite dostopati z API-jem. Zahteva za API na koncu ni popolna, če v URL ne vključite končne točke.

Odziv API-ja

Odgovor je tisto, kar API pošlje nazaj vsakič, ko prejme zahtevo iz vaše aplikacije. Lahko je JSON, XML ali HTML, odvisno od podatkov ali vrste vsebine, ki jih prejme iz glave zahteve.

Ko dobite odgovor iz API-ja, lahko svoj klic API štejete za uspešen.

Kako uporabljati API-je: praktični primeri

Zdaj, ko poznate osnove API-jev in kaj morate vključiti. Oglejte si, kako povezati in integrirati API za nogometno napoved RapidAPI z uporabo Pythona spodaj.

To je preprost klic API, ki vrne odgovor JSON. Kodo lahko tudi napišete v kateri koli urejevalnik besedilin ga zaženite prek ukazne vrstice.

Sorodno: Kako zagnati skript Python

Vendar bodite pozorni na končno točko, vsebino glave zahtev in glave odziva:

zahteve za uvoz
končna točka = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federation": "UEFA"}
#Definirajte glavo zahteve:
glave = {
'x-rapidapi-key': "Prilepite svoj ključ za dostop sem",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
# Določite glavo odziva:
response = zahteve.request ("GET", končna točka, glave = glave, params = queryparams)
# Pridobite odgovor:
tiskanje (response.text)

Nadaljujte z učenjem: Kako uporabljati API IPStack za iskanje po geolokaciji IP

Kako pa je, če uporabimo trenutno temperaturo in vlažnost prostora API Weatherstack s Pythonom? Tu je primer spodaj:

zahteve za uvoz
končna točka = ' http://api.weatherstack.com/current'
glave = {
"access_key": "Prilepite svoj ključ za dostop sem",
"query": "California"
}
req = prošnje.get (končna točka, glave)
res = req.json ()
print (u "Trenutna temperatura v% s je% d ℃"% 
(res ["lokacija"] ["ime"], res ["trenutno"] ["temperatura"]))
print (u "Trenutna vlažnost v% s je% d ℃"% 
(res ["lokacija"] ["ime"], res ["trenutno"] ["vlažnost"]))

Vrste API-jev, ki jih lahko integrirate

Odprtokodni API-ji so brezplačni in jih lahko uporablja vsak. Notranji API-ji se nahajajo znotraj organizacije in samo aplikacije, ki pripadajo tej organizaciji, lahko uporabljajo njene vire.

Lahko pa se odločite tudi za namenski API, tako da s ponudnikom sklenete partnersko pogodbo. Lahko pa kombinirate več API-jev za reševanje različnih težav.

Tudi ti API-ji, razen odprtokodnih in notranjih API-jev, imajo lahko ceno, ki se včasih giblje od sto do tisoč dolarjev.

Poenostavite razvoj aplikacij z API-ji

Kot vidite, vam ni treba več pisati zamudne kode. Če potrebujete svojo aplikacijo za izvajanje zapletenih operacij, lahko tam vedno poiščete in zgrabite ustrezen API. Na srečo jih je zdaj celo enostavno vključiti kot stare običajne. Če ste radovedni in želite izvedeti več, obstaja veliko brezplačnih API-jev, s katerimi si lahko umažete roke.

Kako API-ji delujejo in kako jih integrirati v vašo aplikacijo

Uporaba programskih vmesnikov (API-jev) je bistvena veščina, ki jo morajo obvladati vsi programerji.

Preberite Naprej

O avtorju