REST API Monivio
Programatický prístup ku všetkým tvojím dátam – kontakty, faktúry, náklady, pokladničné doklady, obchodné záznamy a kalendár. JSON cez HTTPS, autentifikácia API kľúčom, OpenAPI 3.1 špecifikácia.
Tvoj prvý request
Po vytvorení API kľúča v Nastavenia → API kľúče ho pošleš v Bearer formáte. Všetky endpointy bežia pod /api/v1.
curl https://monivio.sk/api/v1/contacts \
-H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Začíname
Autentifikácia
Vytvor API kľúč v UI a pošli ho v Authorization hlavičke. Scope-y a typy kľúčov.
OpenAPI / Swagger
Strojová špecifikácia pre Postman, openapi-codegen a interaktívne UI na otestovanie.
Chyby a status kódy
Konzistentný tvar chybovej odpovede + zoznam HTTP kódov a error.code hodnôt.
Rate limiting
Limity podľa plánu, hlavičky X-RateLimit-* a osvedčené postupy pri 429.
Resources
Pre každý zdroj nájdeš zoznam endpointov, request/response príklady v 4 jazykoch (cURL / TypeScript / Python / PHP) a kompletnú schému objektu.
Kontakty
CRUD pre obchodných partnerov, dokumenty kontaktu, štatistiky.
Dokumenty
Faktúry, ponuky, dobropisy, dodacie listy a drafty. PDF + odoslanie emailom.
Náklady
Prijaté faktúry a bločky. Service vypočíta totals z line_items.
Pokladnica
Pokladne, PPD/VPD doklady, mesačné štatistiky.
Obchodné záznamy
Zmluvy a dokumenty s platnosťou. Multipart upload, PDF, anotácie.
Katalóg
Produkty a služby s cenami a skladovými stavmi.
Kategórie
Hierarchická kategorizácia príjmov a nákladov.
Tagy
Voľné štítky pre kontakty, dokumenty, náklady.
Číselné rady
Read-only prehľad číselných radov pre dokumenty.
Bankové účty
Read-only zoznam bankových účtov organizácie.
Kalendár
Manuálne udalosti, deadliny a pripomienky.
Vyhľadávanie
Univerzálny fulltext + sémantické vyhľadávanie naprieč entitami.
Webhooks
Event-based notifikácie podpísané HMAC SHA-256.
Reference
Zoznamy hodnôt, ktoré API očakáva alebo vracia – meny, krajiny, statusy, chybové kódy, scope-y.