Što je API? API je skup pravila koji omogućuje različitim aplikacijama, programima i digitalnim sustavima da međusobno razmjenjuju podatke i koriste određene funkcije. Umjesto da svaki sustav gradimo od početka, putem API-ja možemo sigurno zatražiti potrebnu informaciju ili pokrenuti određenu radnju.
Svi smo se našli u situaciji kada smo u aplikaciji provjeravali vremensku prognozu, plaćali karticom ili tražili lokaciju na karti. Iako se sve odvija u nekoliko sekundi, aplikacija se u pozadini često povezuje s vanjskim servisima kao što su Google Maps Platform ili Stripe.
Kada razumijemo što je API, lakše možemo shvatiti kako nastaju moderne aplikacije, zašto se različiti servisi mogu povezivati i kako razvojni timovi štede vrijeme. U nastavku donosimo jednostavna objašnjenja, primjere i korake koji pokazuju kako API zapravo funkcionira.
Key takeaways
- API povezuje različite sustave
- Zahtjevi šalju i primaju podatke
- Podaci često dolaze u JSON formatu
- API štedi vrijeme razvoja
- Pristup se može zaštititi ključevima
Što je API u praksi?
Najjednostavnije možemo zamisliti API kao konobara u restoranu. Mi odaberemo jelo i predamo narudžbu konobaru, koji je odnosi u kuhinju. Kuhinja priprema jelo, a konobar nam donosi rezultat.
U digitalnom svijetu korisnička aplikacija šalje zahtjev API-ju. API zahtjev prosljeđuje sustavu koji posjeduje podatke, a zatim odgovor vraća aplikaciji. Pritom aplikacija ne mora znati kako je cijeli vanjski sustav izgrađen.
API nije korisničko sučelje koje vidimo na zaslonu. Riječ je o tehničkom sučelju preko kojeg softverski sustavi komuniciraju prema unaprijed definiranim pravilima.
Kako API zapravo funkcionira?
Komunikacija obično počinje kada klijentska aplikacija pošalje zahtjev određenoj API adresi, poznatoj kao endpoint. Zahtjev može sadržavati informaciju o tome koje podatke tražimo, što želimo promijeniti ili koju radnju želimo pokrenuti.
Poslužitelj obrađuje zahtjev, provjerava je li dopušten i vraća odgovor. Odgovor često sadrži podatke u JSON formatu te statusni kod koji pokazuje je li zahtjev uspješno obrađen.
| Element | Uloga |
|---|---|
| Klijent | Šalje API zahtjev |
| Endpoint | Adresa traženog resursa |
| Poslužitelj | Obrađuje zahtjev |
| Odgovor | Vraća podatke ili poruku |
| Statusni kod | Pokazuje rezultat zahtjeva |
Primjer iz svakodnevice
Kada otvorimo aplikaciju za dostavu, ona može putem API-ja dohvatiti popis restorana, cijene, dostupna jela i status narudžbe. Jedna aplikacija tako komunicira s nekoliko sustava, iako mi vidimo samo jedno jednostavno sučelje.
Koje metode API koristi?
Web API-ji često koriste HTTP metode koje opisuju željenu radnju. Metodom GET obično dohvaćamo podatke, POST koristimo za stvaranje novog zapisa, PUT ili PATCH za ažuriranje, a DELETE za uklanjanje zapisa.
Primjerice, GET zahtjev može dohvatiti podatke o korisniku, dok POST zahtjev može poslati novu narudžbu. Točna pravila ovise o dokumentaciji pojedinog API-ja.
Za testiranje i slanje takvih zahtjeva možemo koristiti platformu Postman, koja nam omogućuje pregled zahtjeva, odgovora, zaglavlja i statusnih kodova bez izrade cijele aplikacije.
Kako se API pristup štiti?
API-ji mogu koristiti različite načine autentifikacije i autorizacije. Često se upotrebljavaju API ključevi, pristupni tokeni ili OAuth protokol. Njima sustav provjerava tko šalje zahtjev i koje radnje smije izvršiti.
API ključ ne bismo trebali javno objavljivati niti ga izravno spremati u kod dostupan korisnicima. Osjetljive podatke čuvamo u sigurnom okruženju, ograničavamo dopuštenja i koristimo šifriranu HTTPS komunikaciju.
Što se događa kada API ne radi?
API može vratiti pogrešku ako zahtjev nije pravilno napisan, korisnik nema dopuštenje ili traženi podatak ne postoji. Status 400 obično označava neispravan zahtjev, 401 problem s autentifikacijom, 404 nepostojeći resurs, a 500 pogrešku na poslužitelju.
Koje vrste API-ja postoje?
Javni API-ji dostupni su vanjskim razvojnim programerima prema pravilima pružatelja usluge. Privatni API-ji koriste se unutar organizacije, dok partnerski API-ji omogućuju suradnju između odabranih tvrtki.
Često susrećemo REST API-je koji se oslanjaju na HTTP metode i resurse. Postoje i SOAP, GraphQL te drugi pristupi, a njihov izbor ovisi o potrebama sustava, količini podataka i načinu komunikacije.
Zašto su API-ji toliko važni?
Kada znamo što je API, postaje jasno zašto ga pronalazimo gotovo posvuda. API omogućuje povezivanje plaćanja, karata, društvenih mreža, analitičkih alata, sustava za prijavu i brojnih drugih usluga.
Razvojni timovi zahvaljujući API-jima ne moraju iznova graditi svaku funkciju. Mogu koristiti postojeće servise, brže razvijati proizvode i jednostavnije automatizirati ponavljajuće zadatke.
Zaključak
Razumijevanje toga što je API pomaže nam shvatiti kako aplikacije razmjenjuju podatke i koriste vanjske funkcije. API prima zahtjev, prosljeđuje ga odgovarajućem sustavu i vraća strukturirani odgovor.
Takvo povezivanje susrećemo u internetskim trgovinama, mobilnim aplikacijama, analitici i područjima kao što je google oglašavanje. Kada savladamo osnovne pojmove, lakše možemo koristiti API dokumentaciju, testirati zahtjeve i razumjeti tehnologiju koja pokreće digitalne proizvode.