API 参考

注意：API 文档正在持续完善中，以下为概要说明，详细接口定义将在后续版本中补充。

通信协议概述

BLE 通信

手机与设备之间的蓝牙通信使用 GATT 协议：

  • Service UUID：待补充
  • Characteristic UUID：待补充
  • 数据格式：待补充

云端 API

手机和设备通过云端 API 进行交互：

  • 基础 URL：待补充
  • 认证方式：待补充
  • 数据格式：JSON

设备管理 API

设备注册

POST /api/v1/devices/register

绑定新设备到用户账户。

设备列表

GET /api/v1/devices

获取当前用户绑定的所有设备列表。

设备状态

GET /api/v1/devices/{device_id}/status

获取指定设备的在线状态、电量等信息。

内容推送 API

文字推送

POST /api/v1/devices/{device_id}/push/text

向设备推送文字内容。

图片推送

POST /api/v1/devices/{device_id}/push/image

向设备推送图片内容。

应用管理 API

安装应用

POST /api/v1/devices/{device_id}/apps/install

向设备推送并安装应用。

卸载应用

DELETE /api/v1/devices/{device_id}/apps/{app_id}

从设备上卸载指定应用。

更新应用

PUT /api/v1/devices/{device_id}/apps/{app_id}/update

更新设备上的指定应用。

设备设置 API

获取设置

GET /api/v1/devices/{device_id}/settings

获取设备的当前设置。

更新设置

PUT /api/v1/devices/{device_id}/settings

更新设备的配置参数。

OTA 更新 API

检查更新

GET /api/v1/devices/{device_id}/ota/check

检查是否有可用的固件更新。

触发更新

POST /api/v1/devices/{device_id}/ota/update

触发设备进行 OTA 更新。

下一步

返回文档中心