Za što API stoji? Definicija skraćenice za kodiranje u običnom engleskom jeziku.

Ne, API ne znači Apple Pie Inside. ?? API je skraćenica od Application Programming Interface (Sučelje za programiranje aplikacija). API-ji omogućuju međusobno povezivanje (ili interakciju) dviju aplikacija.

API skup programskih uputa i funkcija koji se koriste za pristup web mjestu ili softverskoj aplikaciji zasnovanoj na webu. API omogućuje drugim programerima upotrebu podataka i funkcionalnosti vaše aplikacije. Omogućuje interakciju vašeg proizvoda s drugim proizvodima.

API-ji su se prvi put koristili u razvoju softvera i hardvera 1980-ih. Ali sada kada ljudi govore o API-ima, obično se pozivaju na web API-je, ili preciznije RESTful API-je. Uobičajena je praksa koristiti RESTful API-je prilikom razvijanja web aplikacija.

Web API je u osnovi program s kojim u potpunosti komunicirate putem URL-ova. Obično kada putem preglednika pošaljete zahtjev na URL, poslužitelj šalje odgovor koji se prikazuje da biste ga pogledali. Stvari stoje drugačije kada pošaljete zahtjev na URL API-ja. Poslužitelj šalje natrag nešto što bi trebalo biti korisno samo računalu. API vraća podatke koji se mogu koristiti na drugoj web lokaciji ili programu.

Za što se koriste API-ji?

API-ji nisu namijenjeni krajnjem korisniku. Koriste se za softver za interakciju s drugim softverom. Na primjer, web mjesto može uputiti poziv API-ju Open Weather kako bi dobilo vremenske informacije za prikaz na web mjestu.

API-ji se ponekad koriste i interno u okviru jedne tvrtke. Mogu se koristiti za stvaranje internih web stranica i sustava koji međusobno lako komuniciraju.

Kako API funkcionira?

API općenito daje drugima pristup velikoj količini organiziranih podataka. Vratar tih podataka daje programeru dopuštenje (u obliku API ključa ) da od poslužitelja zatraži informacije. Ako je zahtjev uspješan, poslužitelj odgovara porukom, obično u JSON ili XML formatu.

Obično postoji dokumentacija za API koji želite koristiti pod nazivom API specifikacija. Ovo objašnjava kontrole i kako koristiti API.

Evo primjera API specifikacije za OpenWeather API koji vam omogućuje dobivanje trenutnog vremena na određenom mjestu: //openweathermap.org/current

API specifikacije sadrže popis URL-ova pomoću kojih možete dohvatiti podatke. Korištenje jednog od URL-ova naziva se API zahtjev ili API poziv . Specifikacija će često prikazivati parametre i odgovor za svaki URL koji je dio API-ja.

Parametri

Parametri su ono što dodate na kraj URL-a da biste odredili koje podatke želite da API vrati. Parametri su u osnovi varijable koje prosljeđujete API-ju.

URL za dobivanje vremenskih podataka iz OpenWeather API-ja je:

api.openweathermap.org/data/2.5/weather.

Međutim, morate dodati grad kao parametar da biste odredili za koje mjesto želite vratiti vremenske podatke. Evo URL-a s parametrom grada:

api.openweathermap.org/data/2.5/weather?q=London

Ponekad su potrebni parametri da bi se dobio odgovor. Parametri su ponekad neobavezni. U API-ju OpenWeather potrebno je navesti lokaciju, ali osim naziva grada postoje i drugi načini određivanja lokacije. Svi su načini navedeni u specifikaciji API-ja.

Parametri također mogu odrediti stvari poput:

  • Kako sortirati rezultate?
  • Koliko rezultata treba vratiti?
  • U kojem formatu trebaju biti rezultati?
  • Za koji datumski raspon želite rezultate?

Odgovor

Kada API-ju pošaljete zahtjev, dobit ćete povratni odgovor. Vratit ćete podatke koje ste zatražili ili razlog zašto zahtjev nije uspio.

U nastavku je primjer odgovor ste dobili kad ste poslati sljedeći zahtjev: api.openweathermap.org/data/2.5/weather?q=London. To je JSON odgovor.

{ "coord": { "lon": -0.13, "lat": 51.51 }, "weather": [ { "id": 300, "main": "Drizzle", "description": "light intensity drizzle", "icon": "09d" } ], "base": "stations", "main": { "temp": 280.32, "pressure": 1012, "humidity": 81, "temp_min": 279.15, "temp_max": 281.15 }, "visibility": 10000, "wind": { "speed": 4.1, "deg": 80 }, "clouds": { "all": 90 }, "dt": 1485789600, "sys": { "type": 1, "id": 5091, "message": 0.0103, "country": "GB", "sunrise": 1485762037, "sunset": 1485794875 }, "id": 2643743, "name": "London", "cod": 200 }

API odgovor možda neće biti oblikovan kao ovaj primjer. Sav je tekst često u jednom retku. Budući da je uglavnom namijenjeno čitanju računala, a ne osobe, formatiranje nije važno.

API ključevi

Ako sami isprobate gornji URL, nećete dobiti odgovor iznad. Vjerojatno će izgledati više:

{ "cod": 401, "message": "Invalid API key. Please see //openweathermap.org/faq#error401 for more info." }

Većina API-ja zahtijeva neku vrstu provjere autentičnosti prije nego što vrate podatke. To je obično u obliku API ključa . Ti su ključevi poput lozinke. To su dugački niz slova i brojeva koje morate poslati s API zahtjevom, tako da poslužitelj zna da smijete pristupiti informacijama.

Za OpenWeather API, kao i za mnoge druge API-je, API ključ možete dobiti besplatno nakon stvaranja računa. Mnoge tvrtke koriste API ključeve na besplatnim API-ima kako bi osigurale da ljudi ne podnesu mnogo zahtjeva u jednom danu. Doista bi mogao zaglaviti poslužitelj kad bi jedna osoba svake minute poslala tisuće zahtjeva.

Neki su API-ji javni bez API ključa. Ispod je API koji vam omogućuje pronalaženje rimovanih riječi. Kliknite vezu, a zatim pokušajte promijeniti završnu riječ u URL-u kako biste pretražili različite riječi koje se rimuju.

//api.datamuse.com/words?rel_rhy=camp

Želite saznati više?

Ako želite saznati više o korištenju API-ja, pogledajte video u nastavku na YouTube kanalu freeCodeCamp.org.