API pro widget
API poskytuje aktuální uloženou obsazenost saun v JSONu. Je veřejné, bez API klíče a určeno pro read-only použití ve widgetech, například v aplikaci API Widget pro Android. Kompletní REST API a interaktivní testování endpointů naleznete v rozhraní Scalar API Reference.
JSON pro šablonu W12
Vygenerovaný klíč používá endpoint, který vrací přímo pole řádků požadované aplikací API Widget, ne obecný objekt detailu. Parametr fields omezuje odpověď na vybrané řádky.
GET /api/v1/widget/kravihora?fields=name,occupancy,age,status
[
{ "key": "Saunový svět Kraví hora", "color": "main" },
{ "key": "Obsazeno", "value": "13 / 80", "color": "info" },
{ "key": "Vytížení", "value": "16.3%", "color": "info" },
{ "key": "Měřeno", "value": "16:30" },
{ "key": "Stáří", "value": "6 min" },
{ "key": "Původ", "value": "Pravidelné" },
{ "key": "Stav", "value": "Zastaralé", "color": "warning" }
]
MCP pro AI asistenty
Aplikace hostuje bezstavový MCP server na /mcp. Nabízí aktuální obsazenost, detail sauny, doporučení nejklidnější sauny i optimálního času návštěvy, denní průběh a dlouhodobé statistiky. Pokud je nastavený Mcp__ApiKey (v Dockeru MCP_API_KEY), posílá klient hlavičku X-Api-Key nebo Authorization: Bearer.
Kompletní REST API (Scalar)
Všechny ostatní REST endpointy (seznam saun, detail sauny, denní historii, dlouhodobé statistiky i doporučení nejlepšího času návštěvy), jejich parametry, schémata a možnost interaktivního testování najdete v rozhraní Scalar.