Potrebujete napojiť webové CRM, rezervačný alebo dochádzkový systém alebo akúkoľvek inú aplikáciu na ABRA Gen? Skvelá interaktívna dokumentácia APIdoc vás veľmi rýchlo a intuitívne prevedie každým zákutím rozhrania API ABRA Gen. Pre vášho IT správcu alebo akéhokoľvek dodávateľa individuálneho riešenia tak nebude problém sa dôkladne zoznámiť s logikou API a tvorbou dotazov.
Interaktívna dokumentácia (v ČJ) je dostupná ako webová aplikácia na adrese:
Webová aplikácia koncentruje do jedného miesta nápovedu ABRA Gen (help.abra.eu), GenDoc.chm – technická dokumentácia ABRA Gen (súbor je súčasťou vašej inštalácie systému) a okrem toho naviac i vaše definované číselníky a definovateľné položky, ktoré môžete mať v systéme vytvorené.
Aplikáciu sme podrobne predstavili v rámci ABRA Tech Day 2021. Pozrite sa na záznam.
Ako sa prihlásiť do APIdoc
Pre prístup do webovej aplikácie musíte zadať celú URL na vaše API a prihlásiť sa menom a heslom používateľa, ktorý má API povolené.
Obr 01: Prihlásenie do APIdoc. Použite prístup ku svojemu API serveru.
Po prihlásení dôjde k načítaniu celej štruktúry vašich API. Zároveň sa pripoja v helpe publikované príklady na použitie API.
Pozn.:
Ak nemáte svoje API publikované do internetu, bude v krátkej dobe pripravená off-line verzia, ktorú si budete môcť inštalovať na váš počítač a nechať si vygenerovať popis na svoj lokálny počítač. Inštalačný soubor off-line aplikácie si môžete stiahnuť pod prihlasovacím oknom na stránke apidoc.abra.eu.
Sandbox s demo dátami
Pre testovanie sa dá využiť pripravená stránka apisandbox.abra.eu, kde je publikované API pre demodáta aktuálnej verzie ABRA Gen. Sandbox však pochopiteľne neobsahuje žiadne zákazkové úpravy vášho systému a nemusí sa zhodovať presne s vašou verziou systému, preto tu môžu byť drobné odlišnosti.
Ako s APIdoc pracovať
Po načítaní štruktúry API môžete zadať do vyhľadávača ľubovoľný objekt (číselník/doklad), ktorý vás zaujíma:
Obr 02: Vyhľadávanie objektu Stredisko.
Dostanete základné funkcie, ktoré API podporuje. Po kliknutí na tlačidlo Zobraziť viac uvidíte štruktúru vášho objektu (strediska) i vrátane definovateľných položiek. Naviac budete mať náhľady volaní všetkých API funkcií, a to ako pre prácu s jedným záznamom, tak i pri zadávaní viac nových záznamov súčasne (dávkovo).
Obr 03: Detailná štruktúra vybraného objektu vrátane definovateľných položiek.
Tieto vygenerované príklady môžete prekopírovať napríklad do aplikácie Postman a vyskúšať ich.
Ak myškou pôjdete do pravej časti čierneho poľa ponúkne sa možnosť skopírovať do ClipBoardu celú URL alebo obsah dotazu.
Obr 04: Kopírovanie dotazu do schránky.
Veľmi zaujímavou záložkou je Builder, ktorý vám umožní konkrétny dotaz zostaviť:
Obr 05: Bulider pre rýchle zostavovanie dotazov.
V ľavom stĺpci si môžete vybrať, akú metódu (v našom prípade metódu GET) chcete zostaviť.
V hornej lište volíte Parametre, aké budú v sekcii Select, Where a pod.
Konkrétne parametre volíte v pravom stĺpčeku.
POZOR: Voľba Spustiť dotaz je dostupná len pri metóde GET, aby ste si omylom nezmenili dáta vo svojej databáze.
Pri všetkých metódach si môžete nakopírovať URL i telo dotazu tlačidlom Copy do clipboardu a vyskúšať napríklad pomocou Postmanu.