Besplatna konsultacija

Pojmovnik · Tehnika

API

API (Application Programming Interface) je dogovoren način na koji dva softvera razmjenjuju podatke i naredbe, npr. web shop i kurirska služba, procesor kartica ili ERP.

Sadržaj stranice
  1. Zašto je API važan za firmu u BiH?
  2. Primjer iz BiH
  3. Najčešće greške s API-jem
  4. Povezani pojmovi
  5. Česta pitanja o API-ju

Zašto je API važan za firmu u BiH?

API određuje koliko posla u firmi može raditi sam. Kad shop preko API-ja automatski kreira pošiljku kod kurira i dobije broj za praćenje, niko ne prepisuje adrese. Kad sistemi nemaju API, podaci se prenose ručno ili preko Excela, uz greške i kašnjenje.

Prije izbora kurira, ERP-a ili alata za e-mail vrijedi pitati da li imaju dokumentovan API. WooCommerce ima ugrađen REST API za proizvode, narudžbe i kupce, a WordPress za sadržaj. Pristup se štiti ključevima koji se čuvaju kao lozinke i nikad ne objavljuju u kodu na sajtu.

Primjer iz BiH

Primjer: web shop s dječijim igračkama iz Banje Luke šalje 50 paketa dnevno. Ranije je radnica svaku adresu prepisivala u portal kurira. Nakon povezivanja preko API-ja kurira, shop pri promjeni statusa narudžbe u „spremno“ sam kreira pošiljku, štampa adresnicu i kupcu šalje broj za praćenje. Jedan sat dnevno prepisivanja nestaje.

Najčešće greške s API-jem

  • API ključevi zapisani u javnom kodu ili poslani e-mailom, bez ograničenja prava.
  • Nema obrade grešaka, pa se narudžba izgubi kad drugi sistem kratko ne odgovara.
  • Integracija se pravi bez dokumentacije i prestane raditi nakon promjene verzije API-ja.
  • Niko ne prima obavijest kad veza prestane raditi.

Povezani pojmovi

Integracije preko API-ja s kuririma, ERP-om i drugim sistemima radimo kroz custom web aplikacije i WooCommerce razvoj. Ostali tehnički pojmovi su u pojmovniku.

Česta pitanja o API-ju

Šta znači API jednostavnim riječima?

API je kao šalter između dva programa: jedan pošalje zahtjev u dogovorenom obliku, drugi vrati odgovor. Korisnik ne vidi razgovor, nego samo rezultat, npr. broj za praćenje paketa. Pravila šaltera opisana su u dokumentaciji API-ja.

Šta je REST API?

REST je najrašireniji stil izrade web API-ja. Podaci se traže i šalju preko standardnih HTTP metoda, a najčešće se razmjenjuju u JSON formatu. WooCommerce, WordPress i većina modernih servisa nude REST API.

Je li API siguran?

Jeste, kad se koristi preko HTTPS-a, s ključevima koji imaju samo potrebna prava i koji se redovno mijenjaju. Rizik nastaje kad ključ procuri ili ima administratorska prava. Ključeve čuvamo na serveru, ne u kodu koji vidi preglednik.

Šta je webhook?

Webhook je obavijest koju jedan sistem sam šalje drugom kad se nešto desi, npr. procesor javi da je plaćanje uspjelo. Za razliku od običnog API poziva, ne treba stalno pitati da li ima novosti. Shopovi webhooke koriste za plaćanja, dostavu i e-mail alate.

Da li svaki kurir u BiH ima API?

Ne mora, a kvalitet dokumentacije se razlikuje. Prije ugovora pitajte kurira za tehničku dokumentaciju ili gotov dodatak za vašu platformu. Bez API-ja ostaje uvoz i izvoz fajlova ili ručni rad.