Flipdot-display/src/esp32/web/web_ui.h

#pragma once

// Web UI of the clock firmware on port 80 (http://<ESP32 IP>/): live view of the display,
// choosing the page, dynamic pages and fonts, bitmaps (upload, draw, store), live mode,
// settings and Home Assistant. The page itself is in web/web_page.h.
//
// JSON API (bitmaps are 418 hex digits, see logic/bitmap_format.h):
//   GET  /api/status            time, WiFi, firmware, Home Assistant, storage
//   GET  /api/screen            what the dots show now {on, live, data}
//   GET  /api/bitmaps           all bitmaps with data {storage, bitmaps:[{name, builtin, data}]}
//   GET  /api/bitmap?name=      one bitmap {name, data}
//   POST /api/bitmap            store {name, data}
//   POST /api/bitmap/delete     {name}
//   GET  /api/pages             dynamic pages {pages:[{name, builtin, page, data (preview)}]}
//   POST /api/pages/save        {name, page} (page format: web/page_json.h)
//   POST /api/pages/delete      {name}
//   POST /api/pages/preview     {page, time ("HH:MM", optional)} -> {data, boxes:[[x,y,w,h]]}
//   GET  /api/fonts             {fonts:[{name, builtin, height}]}
//   POST /api/fonts/save        {name, data (hex, format of logic/font.h)}
//   POST /api/fonts/delete      {name}
//   GET  /api/ha/value?entity=&attribute=  read a Home Assistant value now {value}
//   POST /api/page              {page: a dynamic page or bitmap name}
//   POST /api/live              show now {data}
//   POST /api/live/stop
//   GET  /api/settings          (the MQTT password and HA token are never sent, only *_set)
//   POST /api/settings          changed fields; {settings, restart}
//   POST /api/restart
//   POST /api/recovery
void webUiBegin();
void webUiLoop();