REST API

Čo to znamená

REST API je najrozšírenejší štýl webového rozhrania, cez ktoré si systémy vymieňajú dáta pomocou štandardných požiadaviek protokolu HTTP, najčastejšie vo formáte JSON. Každý údaj, napríklad faktúra či zákazník, má svoju adresu a s údajmi sa pracuje operáciami čítania, vytvorenia, zmeny a vymazania.

Je to konkrétna podoba API, ktorá sa presadila pre jednoduchosť a nezávislosť od programovacieho jazyka. Cez REST API sa prepája e-shop s účtovným softvérom, banka s firemným systémom, CRM s e-mailovým nástrojom či fakturačná aplikácia s platobnou bránou.

Bezpečnosť zabezpečuje šifrované spojenie a overenie prístupu, napríklad API kľúčom alebo tokenom. Doplnkom k REST API býva webhook, cez ktorý systém sám oznámi udalosť, napríklad zaplatenie faktúry, namiesto toho, aby sa druhý systém musel stále pýtať.

Ako to funguje v praxi

Pri výbere účtovného či fakturačného softvéru sa oplatí overiť, či má dokumentované REST API a čo všetko cez neho možno robiť. Integrácia e-shopu s účtovníctvom cez API ušetrí ručné prepisovanie objednávok a faktúr a zníži počet chýb.

Integráciu by mal navrhnúť niekto, kto rozumie oboma systémom aj účtovným pravidlám. Dôležité je určiť, ktorý systém je zdrojom pravdy pre konkrétne údaje, ako sa riešia chyby a duplicitné záznamy a ako sa zmeny overia pred nasadením.

Pri prepojení s bankou sa REST API využíva v rámci open bankingu na sťahovanie výpisov či zadávanie platieb. Účtovná firma tak môže dostávať pohyby na účte automaticky a párovať ich s faktúrami bez čakania na mesačný výpis.

Na čo si dať pozor

API kľúče a tokeny sú ako heslá. Ak sa dostanú do verejného kódu, e-mailu či tabuľky, ktokoľvek môže pristupovať k údajom. Kľúče sa ukladajú bezpečne, majú len nevyhnutné oprávnenia a pri podozrení na únik sa okamžite menia.

Rozhrania sa vyvíjajú a staršie verzie sa vypínajú. Integrácia, o ktorú sa nikto nestará, môže zo dňa na deň prestať fungovať. Treba sledovať oznámenia dodávateľa, logovať chyby a mať jasného zodpovedného za údržbu prepojenia.