API integracija: kako radi i kako se spojiti na API

API integracija je automatsko povezivanje dvaju programa preko njihovih API-ja, tako da jedan sustav sam šalje ili čita podatke iz drugoga bez ručnog prepisivanja. Primjer: web shop svaku novu narudžbu odmah pošalje u računovodstvo, a skladište dobije nalog za pakiranje.

Kratak odgovor

• API (Application Programming Interface) dogovoreni je način na koji jedan program traži podatke ili radnju od drugoga.
• Spajanje na API ima sedam koraka: dokumentacija, ključ ili OAuth, testna okolina, krajnje točke, webhook ili polling, obrada pogrešaka i zapisivanje.
• Webhook javlja promjenu čim se dogodi, a polling svakih nekoliko minuta pita ima li čega novog.
• Trošak ovisi o broju sustava, kvaliteti njihovih API-ja, mapiranju podataka i zahtjevima za nadzor.

Što je API, na poslovnom jeziku

Zamislite API kao šalter s jasnim pravilima. Program pošalje zahtjev (npr. “daj mi narudžbe od 10:00 nadalje”), a drugi program vrati podatke u dogovorenom obliku, najčešće JSON.

Kad dva sustava tako razgovaraju stalno i bez ljudske pomoći, to je API integracija. Na tome počiva svaka ozbiljna automatizacija procesa: podatak se upiše jednom, a svi ga sustavi vide.

Kako se spojiti na API (spajanje na API korak po korak)

1. Dokumentacija. Najprije pročitajte službenu dokumentaciju dobavljača: koje podatke API nudi, kolika su ograničenja broja poziva (rate limit) i koliko dugo vrijedi pojedina verzija.
2. API ključ ili OAuth. Za pristup Vam treba ključ (token) ili prijava preko OAutha, kod koje korisnik odobrava pristup. Ključ se čuva na poslužitelju, nikad u pregledniku ili e-mailu.
3. Testna okolina. Spojite se najprije na testni račun ili sandbox, kako probne narudžbe ne bi završile u stvarnom knjigovodstvu.
4. Krajnje točke (endpoints). Odredite točno koje adrese i polja trebate: narudžbe, artikle, zalihe, kupce. Tražite samo ono što koristite.
5. Webhook ili polling. Ako sustav podržava webhookove, neka Vam sam javlja promjene. Polling koristite kad webhookova nema ili kao povremenu provjeru da ništa nije propušteno.
6. Obrada pogrešaka. Odredite što se događa kad drugi sustav ne odgovara: ponovni pokušaj s razmakom, red čekanja i obavijest odgovornoj osobi. Isti zapis ne smije se upisati dvaput.
7. Zapisivanje (logging) i nadzor. Svaki poziv i svaka greška trebaju ostaviti trag, a upozorenje mora stići prije nego što kupac prijavi problem.

Primjer s brojkama: web shop na Shopifyju i računovodstvo

Pretpostavke (ilustrativne): trgovina na Shopifyjevu planu Standard, 60 narudžbi dnevno, narudžbe idu u računovodstveni program. Podatke o Shopifyju provjerili smo u službenoj dokumentaciji 16. 10. 2026.

Kako izgleda zahtjev. Integracija šalje POST zahtjev na adresu trgovine s verzijom API-ja u putanji (npr. /admin/api/2026-10/graphql.json), a ključ ide u zaglavlje X-Shopify-Access-Token. Odgovor sadrži tražene narudžbe i podatak koliko je bodova upit potrošio te koliko ih je ostalo. Stari REST Admin API Shopify od 1. listopada 2024. vodi kao zastarjeli, pa se nove integracije rade na GraphQL-u (Shopify).

Ograničenje. Plan Standard dopušta 100 bodova u sekundi, a jedan upit ne smije prijeći 1.000 bodova (Shopify). Svaka izmjena (mutacija) zadano košta 10 bodova.

Računica poziva:

Način	Poziva dnevno	Kašnjenje
Polling svakih 5 minuta	24 × 12 = 288	do 5 minuta
Polling svake minute	1.440	do 1 minute
Webhook + provjera svaki sat	60 + 24 = 84	nekoliko sekundi

Kod pollinga svakih 5 minuta najviše 60 od 288 upita donese novu narudžbu, pa je barem 228 (79 %) praznih. Webhook s provjerom svaki sat treba 71 % manje poziva i javlja narudžbu u sekundama.

Zašto ipak provjera svaki sat: Shopify navodi da isporuka webhooka nije zajamčena i preporučuje periodično usklađivanje. Vaš poslužitelj mora odgovoriti unutar 5 sekundi, a nakon greške Shopify pokušava ponovno 8 puta tijekom 4 sata (Shopify).

Gdje ograničenje stvarno smeta: kod velikih promjena. Ako mijenjate cijenu za 5.000 artikala jednom mutacijom po artiklu, to je 50.000 bodova, pa pri 100 bodova u sekundi posao traje najmanje oko 8 minuta. Za takve poslove služe skupne operacije (bulk operations).

O čemu ovisi trošak API integracije

Cijene ne objavljujemo jer ovise o opsegu. Prvi je razgovor besplatan, a fiksnu cijenu dogovaramo pisano prije početka rada. Napor najviše ovisi o:

• Kvaliteti API-ja druge strane. Moderan API s dokumentacijom i testnom okolinom znatno je jednostavniji od izvoza u CSV ili prijenosa preko FTP-a, što je čest slučaj kod hrvatskih računovodstvenih programa.
• Smjeru podataka. Jednosmjerni prijenos narudžbi lakši je od dvosmjerne sinkronizacije zaliha i cijena, kakvu opisuje vodič za povezivanje web shopa s ERP sustavom.
• Mapiranju podataka. Šifre artikala, stope PDV-a, jedinice mjere i popusti moraju se poklapati u oba sustava.
• Količini i brzini. Sinkronizacija u stvarnom vremenu i tisuće zapisa traže redove čekanja i skupne operacije.
• Nadzoru i održavanju. Dobavljači redovito izdaju nove verzije API-ja (Shopify svaka tri mjeseca) i gase stare, pa integraciju treba pratiti. To je posao za pouzdanog razvojnog partnera.

Cijena samih CRM i ERP sustava i njihovih licenci zasebna je tema, koju obrađujemo u članku o cijeni CRM i ERP sustava. O velikim sustavima poput SAP-a i Pantheona više pišemo u članku o ERP integracijama.

Zapier i Make ili integracija po mjeri

Zapier i Make dobri su za jednostavne tokove (jedan okidač, jedna radnja) i manji obujam uz gotove konektore. Teže se nose sa složenom logikom, velikim obujmom i traženjem uzroka kad neki zapis zapne.

Integracija po mjeri ima smisla kad je proces ključan za posao ili kad gotovog konektora nema. Takve integracije radimo u sklopu usluge integracija, a širi tok posla pokriva automatizacija poslovnih procesa.

Često postavljana pitanja

Što je API integracija? API integracija je automatsko povezivanje dvaju programa preko njihovih API-ja. Jedan sustav sam šalje ili čita podatke iz drugoga, pa se ništa ne prepisuje ručno, npr. narudžbe iz web shopa odlaze izravno u računovodstvo.

Kako se spojiti na API? Pročitajte dokumentaciju, nabavite API ključ ili OAuth pristup, spojite se najprije na testnu okolinu, odaberite krajnje točke, odlučite između webhooka i pollinga te dodajte obradu pogrešaka i zapisivanje.

Što je bolje, webhook ili polling? Webhook je brži i troši manje poziva jer sustav javlja promjenu čim se dogodi. Polling je jednostavniji i radi i kad webhookova nema. Najčešće se koriste zajedno.

Koliko košta API integracija? Ovisi o kvaliteti API-ja druge strane, smjeru i količini podataka, mapiranju i nadzoru. Cijenu ne objavljujemo, ali je nakon besplatnog razgovora dogovaramo fiksno i pisano prije početka rada.

Tko održava integraciju nakon izrade? Uz ugovor o održavanju razvojni partner prati nove verzije API-ja i ažurira kod. Bez toga rizik zastarjele verzije snosite Vi.

Povezani članci

• Računovodstvene integracije u Hrvatskoj: Minimax, Synesis, Luceed
• Povezivanje web shopa s ERP sustavom: narudžbe i zalihe
• ERP integracije: SAP, Dynamics i Pantheon

Razmišljate o API integraciji?

Opišite nam koje sustave želite povezati. Na besplatnom razgovoru provjerit ćemo njihove API-je, predložiti webhook ili polling i dogovoriti fiksnu cijenu prije početka rada.

Javite nam se na info@tsunami-digital.com ili putem obrasca za kontakt.