SaunaWatch · veřejné JSON API

SaunaWatch

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.

Vytvořit klíč pro API Widget

Vyber saunu a vzhled. Klíč zkopíruj do aplikace API Widget v Androidu.

Řádky ve widgetu

Klíč používá formát v1::w12::vzhled::json::URL a odkazuje na W12 JSON endpoint níže.

Klíč používá doménu této stránky. V aplikaci musí být veřejně dostupná přes HTTPS.

Widget endpoint: /api/v1/widget/kszcb

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.