Kad netko kaže „treba nam API“, često misli „neka se to samo spoji“. API nije ljepilo koje se stavi i zaboravi. API je dogovor: koji podatak ide kamo, u kojem trenutku, i što se dogodi kad druga strana kaže ne.
Webshop bez tog dogovora i dalje može biti lijep. Kupac plati, stigne mail, vi otvorite tri programa. U jedan upišete račun. U drugi adresu za GLS ili Overseas. U treći skinete lager jer je netko u dućanu prodao isto. To nije izrada webshopa. To je izlog plus smjena.
Što API radi u običnom tjednu
Kupac na webu naruči. Shop zna tko je, što je, koliko je, koja je dostava, je li kartica ili pouzeće. Taj paket informacija treba otići tamo gdje se stvarno radi posao: u knjigovodstvo, u skladište, kuriru, ponekad natrag na blagajnu. API je cijev. Cijev nije proizvod. Proizvod je da nitko u 17:40 ne prepisuje ulicu s kvačicom.
Dva sustava ne zovu stvari istim imenom. Shop ima „kupca“. Fakturko ima partnera. GLS ima primatelja. Blagajna ima artikl i barkod. Integracija je prijevod plus pravila. Pravilo je dosadno i skuplje od prijevoda: što ako nema lagera, što ako je adresa kriva, što ako je već fakturirano, što ako kurir vrati grešku u petak.
Što od toga osjeti čovjek koji naručuje
Ne osjeti riječ API. Osjeti je li tracking stigao. Osjeti smije li odabrati paketomat. Osjeti stigne li račun s istim iznosom koji je platio. Osjeti javi li mu netko SMS-om da paket ide. Ako to kasni ili laže, krivi shop, ne „integraciju“. I ima pravo. Shop je lice. Cijev je kralježnica.
Zato kompleksniji sustavi nisu hobi za velike. Ima smisla čim imate ritam: deset, dvadeset, pedeset narudžbi, i iste ruke u uredu. Ručni korak tada nije pet minuta. Postaje red, greška, paket na krivu adresu, račun koji ne prati pošiljku.
Što ne spajati prvi dan
Ne sve. Prvo ono što se ponavlja i što boli kad se krivo prekuca: broj narudžbe, iznos, SKU, adresa, OIB, pouzeće. Kartica je higijena. Most nakon uspješnog plaćanja je priča. Mail iz osobnog Gmaila nije most. To je ljubaznost dok netko nije na godišnjem.
Ako razmišljate o izradi webshopa ili o nadogradnji onog koji već prodaje, pitajte se samo ovo: što se dogodi pet minuta nakon što kupac plati. Ako je odgovor „stigne nam mail pa prepišemo“, imate posao. Taj posao se zove API integracija, čak i kad ga u ponudi netko upakira kao „sitni plugin“.