Kde nájdem API kľúče v aplikácii?

V module MonivioIntegration. Vľavo hore kliknite na prepínač platformy (predvolene ukazuje MonivioDocuments), zvoľte MonivioIntegration a v ľavom menu sa objaví sekcia Integrácia s položkou API kľúče.

Kde nájdem popis endpointov?

V module MonivioIntegration v položke API dokumentácia. Nájdete tam zoznam zdrojov, parametre a formáty odpovedí.

Stratil som API kľúč, dá sa znova zobraziť?

Nie. V databáze je uložený len jeho odtlačok. Vytvorte nový kľúč a starý revokujte.

Aký je rozdiel medzi revokovaním a zmazaním kľúča?

Revokovanie kľúč okamžite znefunkční, ale záznam o ňom zostane v zozname aj s históriou. Zmazanie odstráni aj záznam.

Ako obmedzím, čo integrácia vidí?

Pri vytváraní kľúča zvoľte typ Len čítanie a zaškrtnite iba tie oblasti, ktoré integrácia potrebuje — napríklad len doklady a kontakty.

Má zmysel dať kľúču expiráciu?

Áno, pri dočasných integráciách alebo pri práci s externým dodávateľom. Po uplynutí platnosti kľúč sám prestane fungovať a nemusíte naň myslieť.

Môže mať každá integrácia vlastný kľúč?

Áno a odporúčame to. Keď jeden systém odpojíte alebo jeho kľúč unikne, revokujete len ten jeden a ostatné integrácie bežia ďalej.

Kde uvidím, koľko volaní API mám?

V module MonivioIntegration v sekcii Dashboard je graf volaní REST API za posledné dni spolu s počtom chýb a prehľadom aktívnych kľúčov a webhookov.

API kľúče

Kedy to budete potrebovať

Keď chcete Monivio prepojiť s iným systémom — e-shopom, skladom, vlastnou aplikáciou alebo účtovným programom. API kľúč je heslo tejto integrácie: dokazuje, že volania na REST API patria vašej organizácii.

Toto je technická časť určená vývojárom. Popis endpointov a formátov nájdete v API dokumentácii (posledná položka menu modulu Integrácia).

Krok 1: Prepnite sa do modulu MonivioIntegration

API kľúče nie sú v bežnom menu s faktúrami. Kliknite vľavo hore na prepínač platformy (nad ľavým menu, predvolene ukazuje MonivioDocuments) a vyberte MonivioIntegration — modul so synchronizáciou, API a webhookmi.

Prepínač platformy s vybranou možnosťou MonivioIntegration — Bez prepnutia platformy API kľúče ani webhooky v menu neuvidíte.

Ľavé menu sa prepne a v sekcii Integrácia nájdete API kľúče, Webhooky, Analytics a API dokumentáciu.

Krok 2: Vytvorte API kľúč

V sekcii Integrácia → API kľúče kliknite na Vytvoriť API kľúč.

Zoznam API kľúčov s tlačidlom na vytvorenie nového — Pri každom kľúči vidíte typ, oprávnenia a kedy bol naposledy použitý.

V dialógu vyplníte:

Pole	Popis
Názov	Aby ste vedeli, ktorá integrácia kľúč používa (napr. „E-shop“)
Typ	Len čítanie alebo Čítanie a zápis
Oprávnenia	Ku ktorým oblastiam má kľúč prístup — doklady, kontakty, náklady, katalóg, kategórie, tagy, číselné rady, webhooky a ďalšie
Expirácia	Nikdy, 30 dní, 90 dní, 1 rok alebo vlastný dátum

Dialóg vytvorenia API kľúča s výberom oprávnení — Oprávnenia nastavujte po oblastiach — integrácia má vidieť len to, čo naozaj potrebuje.

Krok 3: Kľúč si hneď uložte

Po vytvorení sa kľúč zobrazí jediný raz. Skopírujte si ho do správcu hesiel alebo do konfigurácie svojho systému — po zatvorení okna ho už Monivio nezobrazí, v databáze je uložený len jeho odtlačok.

Okno s vygenerovaným API kľúčom a upozornením, že sa zobrazí len raz — Ak si kľúč nestihnete uložiť, jediná cesta je vytvoriť nový.

Ak kľúč uniknol, okamžite ho revokujte. Prestane fungovať hneď a nedá sa znovu aktivovať — pre integráciu vytvorte nový. Revokovaný kľúč zostáva v zozname aj s históriou; Zmazať odstráni aj samotný záznam.

Krok 4: Sledujte, či a ako sa kľúč používa

Na karte kľúča vidíte dátum posledného použitia. Podrobnejší pohľad ponúka Integrácia → Dashboard: graf volaní REST API za posledné dni, počet chýb a prehľad aktívnych kľúčov a webhookov.

Integration dashboard s grafom volaní API — Graf sa naplní po prvom volaní REST API vaším kľúčom.

Pre každú integráciu vytvorte samostatný kľúč. Keď jeden systém odpojíte alebo unikne, revokujete len jeho kľúč a ostatné integrácie bežia ďalej.

Čo ďalej?

Webhooky — nech vás Monivio samo upozorní, keď sa niečo stane
Prechod zo SuperFaktúry — jednorazový prenos dát API kľúč nepotrebuje
Zmena hesla a dvojfaktorové overenie — zabezpečte účet, z ktorého sa kľúče vytvárajú