Preskoči na glavno vsebino

API Ninja - Úvod

Natrénujte si zručnosti v REST API ABRA Flexi na úroveň Ninja

Avtor: Petr Pech

Plánujete napojenie ABRA Flexi na Váš e-shop či iný systém? Nevyznáte sa v pojmoch REST, API, URL alebo POST? Máte svojho programátora, ale chcete mu rozumieť a naučiť sa obratné chvaty s naším API Flexi? Pripravili sme pre Vás tréningový plán, ktorý Vám pomôže stať sa API Ninjom.

Čo je REST API a na čo je dobré?

ABRA Flexi je vďaka API možné prepojiť s akoukoľvek aplikáciou. Najčastejším prípadom je napojenie na e-shop či CMS. Flexi je prístupné cez desktopovú a webovú aplikáciu, ale zároveň je možné k nemu pristupovať programovo, cez REST API. Odtiaľ sa dostávame k pojmu API (skratka pre Application Programming Interface), ktorý v informatike označuje rozhranie pre programovanie aplikácií.

Naše API okrem implementácie štyroch základných metód známych pod pojmom CRUD (Create, Read, Update a Delete) zvláda rad zaujímavých vecí. Vďaka kvalitnému dotazovaniu je možné napríklad naraz zobraziť nielen celý objekt, ale aj konkrétne parametre – názov firmy, IČO, počet zamestnancov a ďalšie údaje.

Využívame architektúru REST (Representational State Transfer), ktorá je intuitívna, umožňuje pracovať s viacerými formátmi a ponúka široké pole možností. Stav aplikácie a správanie je vyjadrený takzvaným resourcom, každý resource musí mať unikátny identifikátor (URI, URL), v našom prípade napríklad https://demo.flexibee.eu/c/demo/faktura-vydana/1.xml

Základom komunikácie sú dáta vo formáte XML a JSON. REST API Flexi dokáže exportovať a importovať dáta aj v ďalších formátoch (CSV, XLS, PDF, EDI a ďalšie). Viac podrobností vrátane príkladov si ukážeme počas tréningu.

Tréningový plán API Ninja

Počas tréningu na API Ninju sa budeme venovať jednotlivým témam od najjednoduchších krokov, ako je získanie záznamu z Flexi, po najzložitejšie triky a pokročilé akcie, kde príkladom za všetky môže byť odpočet záloh. Jediný postup, ako sa stať API Ninjom, je prejsť tréningový plán od prvých lekcií až do konca. Jednotlivé témy obsahujú vždy tri úrovne náročnosti príkladov:

Učeň - základné príklady na pochopenie problematiky

Bojovník - pokročilé príklady pre ašpirantov na Ninja úroveň v danej oblasti

Ninja - najzložitejšie konštrukcie a príklady pre skutočných Ninja bojovníkov

Na začiatku tréningu sa tiež dozviete, aké schopnosti si osvojíte po absolvovaní daného tréningu. Teraz sa pozrieme na tréningový plán.

Začíname

Pripravili sme pre Vás testovacie bojisko na adrese https://developer.flexibee.eu/c/ninja. Toto prostredie využijeme pre všetky ukážkové príklady a triky. Ak sa chcete pripojiť a pokračovať v tutoriáli, napíšte nám svoje meno a priezvisko na podporaflexi@abra.eu alebo prostredníctvom chatu.

Zašleme Ti prístupové údaje a boj môže začať, na konci Ťa čaká záverečný test a úspešní API bojovníci dostanú aj certifikát!

Alebo chceš trénovať na vlastnej licencii a ešte nemáš REST API prístup? Najvyšší čas kontaktovať naše obchodné oddelenie a požiadať o API užívateľa na testovanie, alebo rovno požiadať o vývojársku licenciu.

Ste s tem dobili odgovor na svoje vprašanje?