Okrem desktopovej a webovej aplikácie ponúka ABRA Flexi ešte tretiu cestu k vašim dátam: rozhranie REST API. Cez neho možno záznamy čítať, vytvárať, upravovať aj mazať a využívať väčšinu funkcií, ktoré poznáte z aplikácie.
Najväčšie uplatnenie nájde REST API pri prepojení Flexi s inou aplikáciou, typicky s e-shopom, CRM alebo skladovým systémom. Táto séria vás oboznámi so základmi: čím API volať, ako zostaviť adresu, aké operácie a formáty sú podporované a ako vypadajú konkrétne príklady požiadaviek.
⚠️ Prístup k REST API nie je automatickou súčasťou licencie, obstaráva sa samostatne. Bez zakúpeného prístupu rozhranie nevyužijete. Podrobnosti nájdete v článku licencovanie prístupu k API.
Čo REST API dokáže
Cez REST API pracujete s rovnakými dátami ako v aplikácii, len strojovo:
čítať záznamy z jednotlivých evidencií, napríklad vydané faktúry, adresár, cenník alebo skladové karty
vytvárať nové záznamy a aktualizovať existujúce
mazať a stornovať dokumenty
exportovať dáta v rôznych formátoch vrátane tlačových zostáv do PDF
Rozsah toho, čo cez API uvidíte a smiete zmeniť, sa riadi právami užívateľa, pod ktorým sa prihlasujete. Cez rozhranie teda nemožno obísť nastavenia, ktoré platia aj v aplikácii.
Čo potrebujete, než začnete
Licenciu so zakúpeným prístupom k API a vytvoreného užívateľa určeného pre API
Adresu servera a identifikátor firmy, ku ktorej sa budete pripájať
Nástroj na odosielanie požiadaviek, napríklad Postman, cURL alebo vlastný skript
Denný limit počtu požiadaviek
Počet API požiadaviek za deň je obmedzený a líši sa podľa variantu vašej licencie:
Variant licencie | Počet API požiadaviek v cene | Navýšenie objemu |
ABRA Flexi Basic | 5 000 / deň | nemožno dokúpiť |
ABRA Flexi Business | 10 000 / deň | možno dokúpiť |
ABRA Flexi Premium | 20 000 / deň | možno dokúpiť |
U variantov Business a Premium je možné objem požiadaviek nad rámec limitu dokúpiť. Aktuálne ceny nájdete v cenníku.
ℹ️ Pri prekročení limitu server odmietne ďalšie požiadavky a vráti chybu 429. Ako dopyty navrhnúť tak, aby sa do limitu pohodlne zmestili, a ako správne reagovať na chybové stavy, popisuje článok odporúčaných postupov pre prácu s API.
Obsah série
Úvod do REST API (tento článok)
Kam pokračovať ďalej
Až prejdete túto sériu, ponúkajú sa dva nadväzujúce smery:
API Ninja je praktický tréningový seriál s vlastným testovacím prostredím, kde si jednotlivé postupy priamo vyskúšate.
Dokumentácia REST API slúži ako úplná referenčná príručka ku všetkým parametrom, operáciám a formátom.
💡 Ak si nie ste istí, ako API využiť vo svojom konkrétnom scenári, môžete si dohodnúť individuálnu konzultáciu, kde vám s návrhom integrácie pomôžeme.