Ovládání FAPI přes API rozhraní
Kromě standardního způsobu (přes webové rozhraní) lze s FAPI pracovat také pomocí tzv. API (Application Programming Interface) rozhraní.
API je služba umožňující spouštět funkce FAPI pomocí požadavků zasílaných z jiné aplikace. To má význam zejména při propojení s libovolným jiným systémem (typicky např. s vlastním e-shopem), který v této situaci může sloužit pouze jako uživatelské rozhraní pro zadání objednávky, přičemž zbytek prodejního procesu - tedy vystavení faktury, přijetí platby, doručení zakoupeného produktu atd. - se již odehrává ve FAPI.
Když jsme začali FAPI vyvíjet, jedním z našich hlavních záměrů byla snadnost jeho využití a možnost vystavování faktur z dalších aplikací či webových stránek. Toho jsme docílili díky využití API rozhraní pro ovládání FAPI. Ostatně aplikace to má přímo ve svém názvu FAPI = Fakturační API.
K čemu lze API například využít?
- vystavení a úprava faktury
- stažení existujících faktur a pravidelných faktur
- vytvoření, úprava a mazání klientů
- vytvoření, úprava a mazání položek faktury
- zprostředkování funkcí prodejního formuláře atd.
Nejčastější případy použití API přehledně shrnuje tento návod, který využívá knihovnu FAPIClient pro PHP (starší verze ke stažení zde).
Další příklady volání API bez použití knihovny FAPIClient najdete zde.
Dokumentace API
FAPI využívá tzv. REST API. Jeho dokumentaci naleznete na adrese https://web.fapi.cz/api-doc/.
Některé API metody nemusí být ve výše uvedené dokumentaci popsané. Pokud nenajdete to, co potřebujete, obraťte se na naši podporu, kde vám rádi pomůžeme vyřešit konkrétní požadavek.
API klíče
Co je a jak získat api klíč najdete v nápovědě Jak získat API klíč.