svjo.cz - Hlavní stránka

API pro stránky Vašeho SVJ

Stránky Vašeho SVJ mají API, rozhraní pro programy. Vlastní skripty, tabulky, software správce nebo AI asistenti jako ChatGPT či Claude s ním čtou a zapisují údaje Vašeho SVJ se stejnými oprávněními, jaká má člen na stránkách.

Co API pokrývá

  • Oznámení, závady a diskuse

    Čtení, přidávání, úpravy a mazání příspěvků včetně komentářů a příloh, změna stavu závady a sledování komentářů.

  • Kalendář a zasedání shromáždění

    Události kalendáře, zasedání shromáždění s programem a zveřejněné výsledky hlasování na zasedání.

  • Dokumenty

    Seznam dokumentů a jejich kategorie, stažení obsahu, nahrání nového dokumentu a jeho úpravy.

  • Členové, jednotky a vchody

    Členové, jednotky, vchody a obsazenost jednotek po měsících, včetně přidávání a úprav.

  • Měřidla a odečty

    Měřidla a jejich typy, kampaně odečtů a zadávání naměřených hodnot.

  • Revize

    Plány revizí a záznamy o provedených revizích.

  • Ankety a hlasování

    Ankety s výsledky a hlasování člena v anketě. U hlasování per rollam návrhy usnesení, výsledky a vlastní hlas člena ke čtení.

  • Kontakty, skupiny, galerie a předpisy

    Kontakty SVJ, vlastní skupiny členů, fotogalerie a odkazy na právní předpisy.

  • Historie a odeslané zprávy

    Záznam aktivit správy stránek a přehled odeslaných e-mailů a SMS bez jejich obsahu, jen ke čtení.

Hlasování per rollam, nastavení stránek, oprávnění a platby zůstávají jen na stránkách.

Jak přístup funguje

  • Osobní token člena

    Token si člen vytvoří po přihlášení ve svém profilu v části „API přístupy“, pokud mají stránky placenou verzi. Platí nejvýše 365 dnů a člen ho může kdykoli zrušit.

  • Stejná oprávnění jako na stránkách

    Token nikdy nezíská víc, než může člen na stránkách. Přístup zvolený při vytvoření tokenu ho může jen dál omezit.

  • REST, JSON a OpenAPI

    Odpovědi jsou ve formátu JSON a celé API popisuje kontrakt OpenAPI 3.1, ze kterého si běžné nástroje vytvoří klienta.

  • AI asistenti a agenti

    S API pracují i AI asistenti a agenti, například ChatGPT, Claude nebo Gemini. Kontrakt OpenAPI jim popíše, co API umí. Vytvořte jim token jen s přístupem, který potřebují.

  • Bezpečné opakování

    Změnu lze po výpadku spojení zopakovat se stejným klíčem a provede se jen jednou. Výpisy se stránkují kurzorem.

Úplnou dokumentaci API najdete po přihlášení na stránkách svého SVJ v profilu v části „API přístupy“. Pokud stránky teprve zvažujete, napište podpoře a pošleme Vám na dokumentaci odkaz. Co API umí, shrnuje přehled API.

Jak začít s API

Stránky pro své SVJ zřídíte zdarma a dokumentaci API pak najdete v profilu v části „API přístupy“. Tokeny pro programy si členové vytvoří, jakmile si objednáte placenou verzi v sekci „Správce“ → „Placená verze stránek“. Chybu, kterou API vrátí, vysvětluje přehled chyb API.