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é.
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:
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).
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.
Veľmi zaujímavou záložkou je Builder, ktorý vám umožní konkrétny dotaz zostaviť:
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.