Što API predstavlja? Primjeri upotrebe API-ja

API je skraćenica od "Sučelje za programiranje aplikacija". Iako ovo može zvučati neobično ako ste novi u programiranju, lako ih je razumjeti kad ga razbijete. Čak ih svakodnevno upotrebljavate dok upravljate svojim mobilnim telefonom, računalom ili dok pregledavate Internet.

Softver, uključujući web aplikacije, mobilne aplikacije i mnoge druge programe, svijet povezuje putem Interneta. Ali da bi to bilo učinkovitije, mora postojati komunikacijski kanal između ovog softvera - tu dolazi API.

Ovdje ćemo objasniti značenje API-ja i kako ih koristiti.

Što je API?

Znate li kako možete vidjeti videozapise na streaming platformama poput Netflixa i YouTubea, između ostalog? To je moguće jer zahtjev šaljete putem API-ja.

Ili ste zamislili kako možete platiti robu koju kupujete u internetskim trgovinama poput Amazona i eBaya? To je također zato što postoji komunikacijski kanal poznat kao API između vaše banke i aplikacija za kupnju.

To je reklo, API je sučelje s nizom pravila koja poslužitelju vaše aplikacije omogućuju interakciju s poslužiteljem davatelja rješenja tako da možete koristiti njihove resurse. U osnovi definira način na koji aplikacije ili softver međusobno komuniciraju.

Međutim, u nekim slučajevima API omogućuje međusobnu razmjenu podataka. Primjer je veza koja postoji između aplikacija vaše banke i aplikacija internetske trgovine.

API je poput glasnika. Povezuje se s poslužiteljem davatelja usluga na jednom kraju, a također usidrava klijentov poslužitelj s drugog kraja. Zatim daje zahtjev klijenta izvoru podataka (poslužitelj davatelja usluge) i vraća odgovor klijentu. Klijent je ovdje preglednik ili vaša aplikacija.

Kuka, međutim, povezuje vašu aplikaciju s API-jem. To je API krajnja točka. Međutim, puno se stvari odvija iza scene. Objasnit ćemo ovo dalje.

Kako vam API-ji pomažu u bržem razvoju aplikacija

API-ji su pametniji alat za izgradnju besprijekornih i robusnih aplikacija. Bez njih bi izrada sofisticiranih aplikacija potrajala godinama.

Zamislite da vam aplikacija treba za obavljanje složenih operacija, vrste za koju je potrebno puno vremena i truda. A onda se netko pojavi s gotovim programom koji radi točno ono što želite, a možda i bolje.

Ali kako to možete povezati sa svojom aplikacijom? Davatelj usluge, shvativši da bi vam ovo moglo dovesti do poteškoća, rekao je da su stvorili sučelje za povezivanje (API) zbog kojeg se njihov i vaš kôd integriraju bez problema.

To sučelje (API) povezuje se s poslužiteljem koji sadrži njihov kôd. Zatim će vam vratiti relevantne podatke iz akcije njihove skripte.

Naravno, ne želite se dosađivati ​​cijelom njihovom izvornom skriptom. Osim toga, većina modernih API-ja sada se oslanja na standardiziranu REST (Representational State Transfer) tehnologiju. To ih čini vrlo skalabilnim i jednostavnim za integraciju, bez potrebe da se brinete o tome što se odvija unutar ili o stanju vašeg odgovora ili zahtjeva dok su unaprijed formatirani.

Ovaj članak neće dalje objašnjavati REST API. Zasad se usredotočite na osnove.

Priključivanje koda u njihov je bolja ideja od pisanja ispočetka. Da biste to učinili, međutim, morate spojiti svoj kod s API-jem koji su dali. Kako se to radi? Tu na scenu stupa API krajnja točka.

Što je API krajnja točka?

Da bi pojednostavili stvari, davatelji usluga postavljaju URL kako bi povezivanje s njihovim API-jem bilo besprijekorno. Takav je URL Krajnja točka API-ja. Pomoću nje vaša aplikacija može pristupiti njihovom poslužitelju putem API-ja i izravno komunicirati sa svojom skriptom.

Dakle, sve što trebate je zgrabiti krajnju točku, zalijepiti je u svoj kôd, upućivati ​​zahtjeve s njom, prilagoditi odgovore i onda, radi, i vaša je! Stoga API krajnja točka povezuje vašu aplikaciju putem API-ja s rješenjem ili izvorom podataka.

U konačnici, mnogi programi koji nude API-je dostupni su na raznim programskim jezicima, tako da nitko ne može biti isključen iz njihove koristi.

Na taj način kodirate brže i učinkovitije, znajući da teret održavanja API-ja nije na vama već na pružateljima podataka ili rješenja.

Stoga je API krajnja točka komunikacijska kuka koja API veže na poslužitelj resursa na jednom rubu i povezuje ga s poslužiteljem prijamnika na drugom kraju.

To onda znači da vam nije potrebna cijela skripta rješenja koje želite koristiti. Ali vaš kod ne može uspostaviti komunikaciju s njim ako se ne poveže sa svojom API završnom točkom.

Pravila integracije API-ja

Ne postoji čvrsto pravilo za integraciju API-ja. Ima ih na tone, a svaki od njih ima svoja pravila integracije. Ali imajte na umu da očekujete odgovor kad god uspostavite vezu s API-jem.

Način na koji upućujete zahtjeve preko API krajnje točke obično se temelji na pravilima definiranim davateljem, ali ono što radite s odgovorom koji dobijete ovisi o vašoj želji. U osnovi ga možete izvrtati kako želite da se prilagodi iskustvu i sučelju korisnika vaše aplikacije.

Ponekad vam je potreban i autentifikator da biste mogli pristupiti API-ju. Takvi autentifikatori obično dolaze kao pristupni tokeni ili API ključevi. Nakon što ovaj token prođe test provjere autentičnosti, API tada signalizira krajnju točku da uspostavi vezu između vaše aplikacije i poslužitelja davatelja usluge.

Kao potrošač API-ja, ne morate brinuti o tim parametrima jer ih pružatelj API-ja čini dostupnima. Izvrsni API također bi trebao navesti kako možete pristupiti i koristiti njegove resurse u svojoj dokumentaciji. Stoga uvijek pripazite na to kad ga pokušavate integrirati.

Da bi se zaokružio, API poziv je sve o zaglavlja, an krajnja točka, zahtjev, i odgovor ili tijelo.

Iako smo objasnili što je krajnja točka, podijelimo dalje ove pojmove:

Zaglavlja

Obično trebate opisati dva oblika zaglavlja tijekom povezivanja s API-jem: zahtjev i odgovor zaglavlja.

The zaglavlje zahtjeva je pristupnik API poziva. Opisuje pristup klijenta pristupu resursu. Može sadržavati detalje poput prihvatljive vrste veze, podataka o proxyju i tipa podataka (JSON, XML ili HTML) koji želite dobiti iz API-ja.

Kao što smo ranije opisali, ovisno o vrsti API-ja s kojim se povezujete, možda ćete morati pružiti jedinstveni token za provjeru autentičnosti i u zaglavlju zahtjeva. Davatelj obično daje ovo.

The zaglavlje odgovora, s druge strane, tvrdnja je o podacima koji dolaze s poslužitelja davatelja usluge. Daje vašoj aplikaciji informacije o karakteristikama davatelja usluge. U osnovi, osigurava da vaša aplikacija odobri pristup odgovoru koji dolazi iz API-ja.

Zahtjev za API

Zahtjev za API obično sadrži krajnju točku u URL-u (Unique Resource Locator). Koristi protokol za prijenos hiperteksta (HTTP) za pronalaženje adrese resursa kojem pokušavate pristupiti pomoću API-ja. U konačnici, zahtjev za API nije potpun ako u URL ne uključite krajnju točku.

API odgovor

Odgovor je ono što API šalje natrag svaki put kad primi zahtjev od vaše aplikacije. To može biti JSON, XML ili HTML, ovisno o podacima ili vrsti sadržaja koje prima iz zaglavlja vašeg zahtjeva.

Jednom kada dobijete odgovor od API-ja, tada svoj API poziv možete smatrati uspješnim.

Kako koristiti API-je: Praktični primjeri

Sad kad znate osnove API-ja i što vam je potrebno za integriranje. Pogledajte kako povezati i integrirati API za predviđanje nogometa iz RapidAPI koristeći Python u nastavku.

To je jednostavan API poziv koji vraća JSON odgovor. Također možete napisati svoj kod bilo koji uređivač teksta, i pokrenite ga putem naredbenog retka.

Povezano: Kako pokrenuti svoju Python skriptu

Međutim, dobro obratite pažnju na krajnju točku, sadržaj zaglavlja zahtjeva i zaglavlja odgovora:

zahtjevi za uvoz
krajnja točka = " https://football-prediction-api.p.rapidapi.com/api/v2/predictions"
queryparams = {"market": "classic", "iso_date": "2021-01-01", "federation": "UEFA"}
#Definirajte zaglavlje zahtjeva:
zaglavlja = {
'x-rapidapi-key': "Zalijepite svoj pristupni ključ ovdje",
'x-rapidapi-host': "football-prediction-api.p.rapidapi.com"
}
#Definirajte zaglavlje odgovora:
response = request.request ("GET", krajnja točka, zaglavlja = zaglavlja, params = queryparams)
# Dobijte odgovor:
ispis (response.text)

Nastavi učiti: Kako se koristi IPStack API za IP Geolocation Lookups

Što kažete na to da koristite trenutnu temperaturu i vlažnost mjesta API za Weatherstack s Pythonom? Evo primjera u nastavku:

zahtjevi za uvoz
krajnja točka = ' http://api.weatherstack.com/current'
zaglavlja = {
"access_key": "Ovdje zalijepite svoj pristupni ključ",
"upit": "Kalifornija"
}
req = request.get (krajnja točka, zaglavlja)
res = req.json ()
ispis (u "Trenutna temperatura u% s je% d ℃"% 
(res ["lokacija"] ["naziv"], res ["trenutno"] ["temperatura"]))
ispis (u "Trenutna vlažnost u% s je% d ℃"% 
(res ["lokacija"] ["naziv"], res ["trenutno"] ["vlažnost"]))

Vrste API-ja koje možete integrirati

API-ji otvorenog koda su besplatni i svatko ih može koristiti. Interni API-ji nalaze se u organizaciji i samo aplikacije koje pripadaju toj organizaciji mogu koristiti njene resurse.

Međutim, možete se odlučiti i za namjenski API ulaskom u ugovor o partnerstvu s davateljem usluga. Ili možete kombinirati nekoliko API-ja za rješavanje različitih problema.

Također, ovi API-ji, isključujući otvorene i interne API-je, mogu imati cijenu, koja se ponekad kreće od stotina do tisuća dolara.

Pojednostavite razvoj aplikacija pomoću API-ja

Kao što vidite, više ne morate pisati dugotrajan kod. Ako vam aplikacija treba za obavljanje složenih operacija, uvijek možete tamo potražiti i dohvatiti odgovarajući API. Srećom, sada ih je čak lako integrirati od starih konvencionalnih. A ako ste znatiželjni i želite znati više, postoji mnogo besplatnih API-ja koji vam mogu pomoći zaprljati ruke.

Kako API rade i kako ih integrirati u vašu aplikaciju

Korištenje sučelja za programsko programiranje (API-ji) osnovna je vještina kojom svi programeri moraju ovladati.

Pročitajte Dalje

O autoru