Jako jedni z prvních jsme do účetní aplikace přidali funkci REST API. ABRA FlexiBee jsme chtěli otevřít novým možnostem, o kterých rozhodujete vy. Chcete si ho vyzkoušet?
Aktivovat vývojářskou licenciDokumentace REST
Od začátku se snažíme, aby naše API bylo čisté, jasné a srozumitelné. K dispozici je vám přehledná dokumentace a díky fantastické práci nezávislého vývojáře Vítka Dvořáka také knihovna PHP ABRA Flexi, která pomocí PHP komunikuje s REST API Flexi. Podobnou službu Vám nabídne i unimapper.
REST API Design
-
Proč REST
Protože je intuitivní, umožňuje pracovat s více formáty a nabízí široké pole možností. Naše API kromě implementace čtyř základních metod známých pod pojmem CRUD (Create, Read, Update a Delete) zvládá řadu zajímavých věcí. Díky kvalitnímu dotazování jde například najednou zobrazit nejen celý objekt, ale i konkrétní parametry – název firmy, IČO, počet zaměstnanců a další údaje.
-
XML a JSON
Základem komunikace jsou data ve formátu XML a JSON. REST API Flexi dokáže exportovat a importovat data i v dalších formátech (CSV, XLS a další).
-
WebHooks
Představují způsob, jak se ve vaší aplikaci v reálném čase dozvíte o změně v ABRA Flexi. Princip je jednoduchý: když dojde v databázi systému ke změně, během několika málo vteřin se odešle POST HTTP request na všechna zaregistrovaná URL. Obsahem požadavku je výpis všech změn od posledního zavolání hooku, a to ve stejném formátu, jaký získáte od ABRA FlexiBee přes rozhraní Changes API.
API ABRA Flexi v praxi
ABRA FlexiBee jde díky API propojit s jakoukoliv aplikací. Nejčastějším případem je napojení na e-shop, tím aktuálním zase automatické odesílání přijatých plateb do EET. K oběma příkladům jsme na webu připravili návod: