小屏幕 API 服务

当前站点根地址（请用浏览器或客户端访问此前缀）：

http://127.0.0.1:8080

1. 开放接口（给设备 / 第三方调用）

方法均为 POST，请求头需带 Content-Type: application/json，路径接在上面的根地址后面。

版本检查

http://127.0.0.1:8080/version

示例（终端里可复制执行，需已安装 curl）：

curl -s -X POST "http://127.0.0.1:8080/version" \
  -H "Content-Type: application/json" \
  -d '{"token":"DEVICE_TOKEN","code":"DEVICE_CODE","firmwareVersion":"1.0.1","filesystemVersion":"1.0.0","mac":"AA:BB:CC:DD:EE:FF"}'

车辆信息（无 mac 为运行时刷新；有 mac 为出厂检测）

http://127.0.0.1:8080/vehicle-info — 成功时 carInfo 为数组（后台可配置 1～3 辆车）。

curl -s -X POST "http://127.0.0.1:8080/vehicle-info" \
  -H "Content-Type: application/json" \
  -d '{"token":"DEVICE_TOKEN","code":"DEVICE_CODE"}'
curl -s -X POST "http://127.0.0.1:8080/vehicle-info" \
  -H "Content-Type: application/json" \
  -d '{"token":"CONFIG_TOKEN","code":"CONFIG_CODE","mac":"AA:BB:CC:DD:EE:FF"}'

2. 在线调试（Swagger）

在浏览器打开：http://127.0.0.1:8080/docs

在页面里选 POST /version 或 POST /vehicle-info，点 「Try it out」填 JSON 即可试调。

3. 后台管理

或直接进后台首页（未登录会跳到登录）：http://127.0.0.1:8080/admin

4. 本机启动命令（在项目根目录）

cd 项目根目录
.venv/bin/uvicorn app.main:app --host 0.0.0.0 --port 8080

--host 0.0.0.0 表示局域网内其他设备也可用「本机 IP + 端口」访问；仅本机则用 127.0.0.1:8080。