Kromě desktopové a webové aplikace nabízí ABRA Flexi ještě třetí cestu k vašim datům: rozhraní REST API. Přes něj lze záznamy číst, zakládat, upravovat i mazat a využívat většinu funkcí, které znáte z aplikace.
Největší uplatnění najde REST API v propojení Flexi s jinou aplikací, typicky s e-shopem, CRM nebo skladovým systémem. Tato série vás provede základy: čím API volat, jak sestavit adresu, jaké operace a formáty jsou podporované a jak vypadají konkrétní příklady požadavků.
⚠️ Přístup k REST API není automatickou součástí licence, pořizuje se samostatně. Bez zakoupeného přístupu rozhraní nevyužijete. Podrobnosti najdete v článku licencování přístupu k API.
Co REST API umí
Přes REST API pracujete se stejnými daty jako v aplikaci, jen strojově:
číst záznamy z jednotlivých evidencí, například vydané faktury, adresář, ceník nebo skladové karty
zakládat nové záznamy a aktualizovat existující
mazat a stornovat doklady
exportovat data v různých formátech včetně tiskových sestav do PDF
Rozsah toho, co přes API uvidíte a smíte změnit, se řídí právy uživatele, pod kterým se přihlašujete. Přes rozhraní tedy nejde obejít nastavení, které platí i v aplikaci.
Co potřebujete, než začnete
Licenci se zakoupeným přístupem k API a založeného uživatele určeného pro API
Adresu serveru a identifikátor firmy, ke které se budete připojovat
Nástroj pro odesílání požadavků, například Postman, cURL nebo vlastní skript
Denní limit počtu požadavků
Počet API požadavků za den je omezený a liší se podle varianty vaší licence:
Varianta licence | Počet API požadavků v ceně | Navýšení objemu |
ABRA Flexi Basic | 5 000 / den | nelze připlatit |
ABRA Flexi Business | 10 000 / den | lze dokoupit |
ABRA Flexi Premium | 20 000 / den | lze dokoupit |
U variant Business a Premium je možné objem požadavků nad rámec limitu dokoupit. Aktuální ceny najdete v ceníku.
ℹ️ Při překročení limitu server odmítne další požadavky a vrátí chybu 429. Jak dotazy navrhnout tak, aby se do limitu pohodlně vešly, a jak správně reagovat na chybové stavy, popisuje článek doporučených postupů pro práci s API.
Obsah série
Úvod do REST API (tento článek)
Kam pokračovat dál
Až projdete tuto sérii, nabízejí se dva navazující směry:
API Ninja je praktický tréninkový seriál s vlastním testovacím prostředím, kde si jednotlivé postupy rovnou vyzkoušíte.
Dokumentace REST API slouží jako úplná referenční příručka ke všem parametrům, operacím a formátům.
💡 Pokud si nejste jistí, jak API využít ve svém konkrétním scénáři, můžete si domluvit individuální konzultaci, kde vám s návrhem integrace pomůžeme.