Prvi API MojeSkladište pojavilo se prije 10 godina. Tijekom tog vremena radili smo na postojećim verzijama API-a i razvijali nove. A nekoliko verzija API-a već su stigle pokopati.
U ovom članku bit će mnogo svega: kako smo stvorili API, zašto je potreban oblačnom servisu, što korisnicima donosi, na koje su nas zamke navele i što želimo raditi dalje.
Zovem se Oleg Alekseev , tehnički sam direktor i suosnivač MojeSkladište.
Zašto napraviti API za servis
Naši klijenti, a to su desetine tisuća poduzetnika, aktivno koriste oblačna rješenja: bankarstvo, internetske trgovine, vođenje zaliha, CRM. Povezali su se s jednim — i sada je teško stati. I tako peti, osmi, deseti servis olakšava rad poduzetnika, ali korisnici ručno prenose podatke između tih oblačnih servisa. Rad postaje noćna mora.
Očigledno rješenje — omogućiti korisnicima prenos podataka između oblačnih servisa. Na primjer, importirati i exportirati podatke kao datoteke koje se zatim mogu učitati u željeni servis. Datoteke se obično prilagođavaju formatu svakog servisa. To je više-manje jednostavan ručni posao, ali kako se broj tih servisa povećava, postaje sve teže izvršiti tu zadaću.
Stoga je sljedeći korak — API. Uz njega oblačni servis dobiva na vrijednosti povezivanje nekoliko servisa na jednoj točki. Pojava takve ekosustava privlači nove klijente kroz dodatne mogućnosti. Proizvod s novom funkcionalnošću postaje isplativiji i korisniji.
Ako se razviju vlastiti softverski interfejsi, to privlači strane prodavače u obliku programera koji znaju za vaš proizvod zahvaljujući API-ju. Oni počinju graditi rješenja na temelju predloženog API-ja i zarađuju novac na automatizaciji zadataka svojih klijenata.
Sustav MojeSklade temelji se na jednostavnim procesima. Ključna stvar je rad s prvotnim dokumentima, mogućnost prihvaćanja i otpreme robe, te generiranje izvještaja za poslovanje na temelju prvotnih dokumenata. Također, omogućena je razmjena podataka, na primjer, u oblak računovodstva, kao i njihovo dohvaćanje iz bankovnih sustava ili maloprodajnih mjesta. Također radimo s internetskim trgovinama: dobivamo informacije o proizvodima i šaljemo podatke o zalihama.

Prvi API MojeSklade
Tijekom 10 godina rada MojeSklade s API-jem stekli smo brojne integracije koje omogućuju razmjenu podataka, suradnju s bankama, izvršavanje plaćanja i korištenje vanjske telefonije.
U prvoj godini omogućili smo izvoz svih podataka u XML formatu. Tada je korisnicima bilo mnogo jasnije i prikladnije držati podatke offline, nego u oblaku, i omogućili smo im to. Izvoz se pokretao ručnim postupkom iz sučelja. Dakle, to još nije bilo moguće nazvati API-jem.
Tada smo također počeli suradnju s tvrtkom Rusagro — oni su već koristili 'zreo' ERP za planiranje proizvodnje i prodaje, dok su automatizirali učitavanje vlakova na tvornicama u MojeSklade. Tako su se pojavili naši prvi koraci prema pravom API-ju: razmjena između naše usluge i ERP-a odvijala se slanjem velikog datoteke s podacima o svim vrstama dokumenata.
To je bio dobar način za pakirnu razmjenu podataka, ali zajedno s dokumentima bilo je potrebno prenijeti njihove zavisnosti: informacije o proizvodima, partnerima i skladištima. Takvu hrpu nije teško generirati pri izvozu, ali je prilično teško obraditi pri uvozu, jer u jednom paketu dolaze svi podaci: i o novim dokumentima i o postojećima.
Prvi XML API nije dugo trajao — nakon dvije godine počeli smo s njegovim preuređenjem. Čak i na samom početku njegovog rada napravili smo nekoliko grešaka pri izgradnji programskog sučelja.

Kako je izrađen XML API: ilustracija jednog od naših arhitekata. Usput, očekujte njegove članke.
Evo naših glavnih grešaka:
- JAXB oznaka napravljena je izravno na entity beans. Za komunikaciju s bazom koristimo Hibernate i na tim je istim beans bila napravljena JAXB oznaka. Ova je greška isplivala gotovo odmah: svaka promjena u strukturi podataka zahtijevala je hitno obavijestiti sve koji koriste API ili izgradnju rješenja koja bi osigurala kompatibilnost s prethodnom strukturom podataka.
- API se razvijao kao neka vrsta dodatka, a prvotno nismo definirali koju dio proizvoda čini. Nismo razmišljali ni o tome je li API nešto važno, treba li podržati povratnu kompatibilnost za prve klijente. U jednom trenutku, broj korisnika API-a činio je oko 5% od ukupnog malog broja, i nismo im posvećivali pažnju. Univerzalna filtracija koja je tada napravljena dovela je do toga da su nas počeli koristiti kao backend. Ta filtracija nije bila pravo GraphQL, ali nešto slično — radila je kroz mnogo parametara u URL-u. S takvim moćnim alatom korisnicima je bilo teško odoljeti, a upiti su prebačeni na način da su se slali izravno putem UI njihovih internetskih trgovina. Situacija je postala neugodno iznenađenje, jer pružanje takve usluge trebalo bi zahtijevati drugačije tarifiranje i potpuno drugačije razumijevanje samog API-a kao proizvoda.
- S obzirom na to da se API razvijao ne kao glavni proizvod, dokumentacija o API-ju rađena je i objavljena po preostalom principu — putem reverznog inženjeringa. Ovakav pristup čini se dovoljno jednostavnim i praktičnim, ali protivi se radu po ugovoru. To je kada postoji određena komponenta s unaprijeđenom shemom rada. Programer je implementira u skladu s tom shemom i zadatkom, komponenta prolazi testiranje, klijent dobiva proizvod koji odgovara zamisli analitičara. Reverzni inženjering na tržištu isporučuje proizvod koji samo postoji: s workaroundovima, čudnim rješenjima i biciklima umjesto potrebnih funkcionalnosti.
- Sve zahtjeve koji su dolazili putem API-ja moguće je analizirati najviše kao log Nginx-a ili aplikacijskog servera. To nije omogućilo isticanje predmetnih područja, osim ako ne razdvojimo po korisnicima i pretplatnicima. Ako nema mogućnosti regulacije registracije aplikacije ili klijenata, analiza situacije postaje nemoguća. Ovaj problem najmanje je utjecao na razvoj API-ja, više se radilo o razumijevanju njegove potražnje i svestranosti funkcionalnosti.
Pokušaj broj dva: REST API
Godine 2010. pokušali smo izgraditi sustav razmjene s online knjigovodstvom – BuxSoftom. Nije uspjelo. Međutim, tijekom integracije nastao je potpuno funkcionalan API: REST-servis za razmjenu, gdje nije bilo slobodnih pristupa poput RPC poziva. Sva komunikacija s API-jem svedena je na standardni REST način: u URL-u zahtjeva nalazi se naziv entiteta, a operacija koja se s njim provodi određena je HTTP metodom. Dodali smo filtriranje prema trenutku ažuriranja entiteta, a korisnicima je omogućeno da grade replikaciju sa svojim sustavima.
Iste godine pojavljuje API za izvoz skladišnih i robnih zaliha. Korisnicima su preko API-ja postali dostupni najvrjedniji dijelovi sustava – razmjena primarnih dokumenata i obračunski podaci o zalihama i troškovima robe.
U prosincu 2015. RetailCRM je objavio prvu vanjsku biblioteku za pristup našem API-ju. Počela se prilično aktivno koristiti, a popularnost servisa općenito je rasla, a opterećenje na API-ju raslo je brže od opterećenja na web sučelju. Jednom je porast postao skok opterećenja.


I taj skok, na koji pokazuje strelica s lijeve strane, doveo je do potpunog zaprepaštenja servera koji opslužuje naš API. Tjedan dana smo istraživali što je točno uzrokovalo ovo opterećenje. Ispostavilo se da su to bili oni zahtjevi koji su se slali našem API-ju s fronta kod klijenata. Sve su to generirala otprilike 50 klijenata. Tu smo shvatili jednu od svojih grešaka – potpuno odsustvo limita.
Na kraju smo uveli limit na broj istovremenih zahtjeva. S jednog računa sada je moguće istovremeno otvoriti najviše dva zahtjeva. To je dovoljno za rad u načinu replikacije za razmjenu podataka u serijskom načinu. A oni koji su htjeli koristiti nas kao backend, od sada su morali bolje odgovarati tarifama, jer su u svojim softverskim alatima uveli rad s više računa.
Sređujemo
Unatrag od 2014. godine, potražnja za postojećim API-jem postala je važan dio poslovanja, a sam API generirao je najveći volumen podataka u razmjeni podataka s klijentima. Godine 2015. pokrenuli smo projekt središnjeg uređivanja API-ja. Odabrali smo format JSON umjesto XML-a i počeli ga graditi na temelju karakteristika koje su uočene prilikom implementacije prethodne verzije:
- Mogućnost upravljanja verzijama. Verzioniranje omogućuje razvoj nove verzije bez utjecaja na postojeću aplikaciju i bez prekidanja rada korisnika.
- Mogućnost da korisnik vidi metapodatke u samom odgovoru koji prima.
- Mogućnost razmjene velikih dokumenata. Ako obrađujemo dokument s brojem stavki većim od 4-5 tisuća, to postaje problem za poslužitelj: duga transakcija, dug http-zahtev. Izgradili smo poseban mehanizam koji omogućuje ažuriranje dokumenta dijelovima i upravljanje pojedinačnim stavkama tog dokumenta, šaljući ih na poslužitelj.
- Alati za replikaciju — bili su i u prethodnoj verziji.
- Limiti opterećenja — kao nasljeđe grešaka na koje smo naletjeli u prethodnoj verziji. Uveli smo limite na broj zahtjeva u vremenskom razdoblju, broj paralelnih zahtjeva i zahtjeva s jedne IP adrese.
Od tada smo objavili dvije manje verzije API-ja i pokrenuli nekoliko specijaliziranih API-ja, no općeniti pristup ostao je nepromijenjen. Ažurirani format razmjene i nova arhitektura omogućili su brže ispravljanje nedostataka u API-ju.
API MojegSklada danas
Danas API MojegSklada rješava mnoge zadatke:
- razmjenu podataka s internetskim trgovinama, računovodstvenim sustavima, bankama;
- prikupljanje obračunskih podataka, izvještaja;
- korištenje kao backend za klijentske aplikacije — naše mobilne aplikacije i desktop blagajna rade preko API-ja.
- slanje obavijesti o promjenama podataka u MomSkladištu — webhooks;
- telefonija;
- sustavi lojalnosti.
Na temelju API-ja naš generalni direktor Askar Rahimberdiev u četiri sata napisao je telegram-bota koji vadi preko API-ja zalihe:
Sad su tu suhi podaci.
Evo naše statistike o starom REST API-ju:
- 400 tvrtki;
- 600 korisnika;
- 2 milijuna zahtjeva dnevno;
- 200 GB/dan odlaznog prometa.
A ovo je do čega smo došli sa svim API-ima MojeSkladište:
- više od 70 integracija (dio njih možete pogledati ovdje );
- 8500 tvrtki;
- 12 000 korisnika;
- 46 milijuna zahtjeva dnevno;
- 2 TB/dan odlaznog prometa.
Što dalje
Planovi za razvoj API-ja su u aktivnoj raspravi. Pokušavamo uzeti u obzir iskustvo korištenja koje nam dostavljaju korisnici. Ne ide uvijek i ne možemo sve odmah realizirati, ali nova verzija API-ja s korisnijim metapodacima i jednostavnijom strukturom, OAuth za autentifikaciju, i API za ugrađene aplikacijske sučelje je skoro na vidiku.
Novosti se mogu pratiti na posebnoj stranici za programere integracija s MojeSkladište: .
Izvor: habr.com
