API (angl. Application Programming Interface) yra sutartas būdas dviem programoms kalbėtis tarpusavyje be žmogaus: viena sistema paprašo duomenų ar veiksmo, kita atsako pagal iš anksto aprašytas taisykles. Jei ieškote atsakymo į klausimą kas yra API be techninių terminų — tai meniu ir padavėjas restorane. Jūs nežinote, kas vyksta virtuvėje, ir jums nereikia: užtenka meniu, kuriame surašyta, ko galima paprašyti, ir padavėjo, kuris užsakymą nuneša ir atneša rezultatą.
Esu Tomas, front-end programuotojas iš Vilniaus. Per aštuonerius su puse metų ir 97+ projektų didelė dalis darbo buvo būtent sistemų sujungimas: parduotuvė su buhalterija, svetainė su CRM, katalogas su tiekėju. Šis straipsnis skirtas verslo savininkui, kuriam nereikia mokėti programuoti, bet reikia suprasti, ką jis perka ir ko klausti.
Kas yra API techniškai: kaip ji atrodo praktiškai
Techniškai API yra adresų rinkinys, į kuriuos siunčiamos užklausos. Dažniausias tipas — REST API, kur kiekvienas adresas atitinka objektą, o veiksmą nurodo užklausos tipas:
| Veiksmas | Ką reiškia | Pavyzdys parduotuvėje |
|---|---|---|
| GET | Paimti duomenis | Gauti visų vakar gautų užsakymų sąrašą |
| POST | Sukurti naują įrašą | Įkelti naują produktą į katalogą |
| PUT / PATCH | Pakeisti esamą | Atnaujinti kainą ir likutį |
| DELETE | Ištrinti | Pašalinti nebeparduodamą produktą |
Atsakymas grąžinamas struktūruotu formatu (dažniausiai JSON) — tvarkingu sąrašu, kurį kita programa perskaito be klaidų. Būtent todėl API skiriasi nuo „nusikopijuoti iš ekrano“: duomenys ateina apibrėžtos formos, todėl juos galima apdoroti automatiškai.
API raktai: kas tai ir kodėl svarbu
Kad į jūsų duomenis nekreiptų kas nori, kiekviena užklausa pasirašoma API raktu — ilga simbolių eilute, kuri atstoja slaptažodį. Trys taisyklės, kurių laikausi visuose projektuose: raktas turi turėti tik būtinas teises (jei sistemai reikia tik skaityti užsakymus, rašymo teisių jai neduodame), jis niekada nerašomas į svetainės kodą matomoje vietoje, ir jis turi būti pakeičiamas neperrašant integracijos.
Webhook — kai sistema praneša pati
Yra ir priešinga kryptis. Įprastu atveju jūsų sistema klausia: „ar yra naujų užsakymų?“ Webhook veikia atvirkščiai — įvykus įvykiui, sistema pati nusiunčia pranešimą nurodytu adresu. Praktinis skirtumas didelis: vietoj tikrinimo kas penkias minutes buhalterija apie naują užsakymą sužino tą pačią sekundę, o serveris neapkraunamas tuščiomis užklausomis.
Kur API integracija naudojama versle
| Sujungimas | Ką sutaupo |
|---|---|
| WooCommerce ↔ buhalterinė programa | Sąskaitos išrašomos automatiškai, be perrašinėjimo ranka |
| Parduotuvė ↔ kurjeriai (Omniva, DPD, LP Express) | Siuntos lipdukas ir sekimo numeris generuojami iš užsakymo |
| Svetainės forma ↔ CRM | Užklausa iškart tampa kortele su šaltiniu ir atsakingu žmogumi |
| Katalogas ↔ tiekėjo sistema | Kainos ir likučiai atsinaujina patys; žr. produktų importą |
| Svetainė ↔ mokėjimų tiekėjas | Apmokėjimo statusas grįžta automatiškai, užsakymas patvirtinamas be žmogaus |
| Sistema ↔ DI modelis | Aprašymai, santraukos ar atsakymai generuojami pagal jūsų duomenis |
Paskutinė eilutė per pastaruosius metus tapo svarbiausia. Dirbtinio intelekto modeliai taip pat pasiekiami per API, o naujesnis standartas MCP leidžia DI asistentui saugiai pasiekti jūsų sistemą — apie tai atskirai rašiau straipsnyje MCP serveris: kas tai ir parodžiau praktinį pavyzdį su WooCommerce automatizavimu.
Ką reiškia „sistema turi API“ renkantis programą
Perkant bet kokią verslo programą — sandėlio, buhalterijos, rezervacijų — verta užduoti penkis klausimus. Jie atskiria tikrą API nuo rinkodarinio pažado:
- Ar yra vieša dokumentacija? Jei jos neprieina be sutarties, integracija bus lėta ir brangi.
- Ką galima daryti, ne tik skaityti? Kai kurios sistemos leidžia tik peržiūrėti duomenis; jei reikia įrašyti, gali paaiškėti, kad to nėra.
- Ar API įeina į kainą? Dalis tiekėjų prieigą parduoda kaip brangesnį planą arba ima mokestį už užklausų kiekį.
- Kokios ribos? Užklausų limitai per minutę lemia, ar galima sinchronizuoti didelį katalogą.
- Ar yra webhook pranešimai? Be jų viskas veiks lėčiau ir sudėtingiau.
Praktinė pastaba iš patirties: sistema be API beveik visada reiškia rankinį darbą amžinai. Todėl renkantis tarp dviejų panašių programų API buvimas dažnai svarbesnis už dizainą ar kainų skirtumą. Tai viena priežasčių, kodėl parduotuvėms siūlau WooCommerce — jo API atvira ir dokumentuota.
Kiek kainuoja API integracija
Kainą lemia ne pati jungtis, o kraštiniai atvejai. Sujungti dvi sistemas „kai viskas gerai“ yra greita; brangu būna aprašyti, kas nutinka, kai tiekėjo serveris neatsako, kai duomenys ateina nepilni, kai tas pats užsakymas atsiunčiamas du kartus arba kai pasikeičia API versija. Todėl bet kokį tokį darbą pradedu nuo dokumentacijos peržiūros ir sąžiningo atsakymo, ar rezultatas vertas pinigų.
Orientyrai: paprastas vienos krypties sujungimas (pvz., forma į CRM) dažnai telpa į kelias valandas, o pilna dvipusė integracija su statusų valdymu ir klaidų apdorojimu yra atskiras projektas. Dažna klaida — automatizuoti procesą, kuris atliekamas du kartus per mėnesį: tokiu atveju rankinis darbas pigesnis, ir tai pasakau iš karto.
Kaip galiu padėti
Pradedu nuo galimybių įvertinimo (40 €/val.): peržiūriu jūsų sistemas ir pasakau, ką realiai galima sujungti, kokia apimtimi ir kokia tvarka. Individuali integracija su išorine sistema — nuo 600 € (buhalterija, sandėlis, CRM, tiekėjo katalogas), o MCP serveris jūsų sistemai — nuo 500 €, kai norite, kad prie duomenų saugiai prieitų DI asistentas. Jei norite dirbti patys, apmokymai — 40 €/val. Daugiau — DI ir MCP integracijų puslapyje, o su WordPress susietus sprendimus aprašiau custom įskiepių puslapyje.
Dažniausiai užduodami klausimai
API kas tai paprastais žodžiais?
Tai sutartas būdas dviem programoms keistis duomenimis. Viena sistema pateikia užklausą pagal aprašytas taisykles, kita grąžina atsakymą — visa tai vyksta automatiškai, be žmogaus, kopijuojančio informaciją iš vienos programos į kitą.
Ar API naudojimas saugus?
Taip, jei laikomasi trijų dalykų: raktui suteikiamos tik būtinos teisės, jis laikomas serveryje, o ne matomame svetainės kode, ir yra galimybė jį pakeisti. Rizika kyla ne iš pačios technologijos, o iš per plačių teisių.
Kuo skiriasi API ir webhook?
API yra klausimas: jūsų sistema kreipiasi ir gauna atsakymą. Webhook yra pranešimas: įvykus įvykiui, kita sistema pati atsiunčia informaciją nurodytu adresu. Praktikoje jie naudojami kartu.
Ar galiu prijungti buhalteriją prie savo e-parduotuvės?
Dažniausiai taip — populiarios Lietuvos buhalterinės programos turi API arba paruoštas jungtis WooCommerce. Pirmas žingsnis visada tas pats: pasitikrinti, ar jūsų programos plane API prieiga įjungta ir ką konkrečiai per ją leidžiama daryti.
Kas nutinka, jei tiekėjas pakeičia API?
Rimti tiekėjai skelbia versijas ir apie pokyčius įspėja iš anksto, todėl integraciją pakanka atnaujinti. Būtent dėl to integracijas kuriu su klaidų registravimu: jei kas nors nustoja veikti, tai matoma iš karto, o ne po mėnesio pastebėjus trūkstamas sąskaitas.
Ar API integracija visada apsimoka?
Ne. Ji apsimoka, kai veiksmas kartojasi dažnai ir klaidos brangios. Jei procesas atliekamas kelis kartus per mėnesį, rankinis darbas dažnai pigesnis — tokiais atvejais taip ir pasakau, užuot siūlęs projektą.