设备固件升级（App）

App 端查询设备可用的升级包并触发升级。前缀：/app-api/iot，均需登录态。

查询设备当前版本信息

方法	接口地址
GET	/app-api/iot/app-user-device/version?productId=

响应参数：data 为该产品下的版本信息（含模块与版本号）。

查询升级包分页

方法	接口地址
GET	/app-api/iot/ota-firmware/page

请求参数（query，均可选）

参数名称	参数说明	数据类型
pageNo / pageSize	分页参数	int
productKey	产品productKey	string
moduleName	模块名称	string
type	包类型；0：整包；1：差分	int
srcVersion / destVersion	待升级版本 / 目标版本	string
status	状态	int

响应参数（data.list 每项）：id、firmwareName、type、productKey、moduleName、srcVersion、destVersion、signMethod、filesInfo（文件信息 JSON）、description、verifyProgress、packageUdi、status、createTime。

触发设备升级

方法	接口地址
POST	/app-api/iot/ota-firmware/update

请求参数（body）

参数名称	参数说明	是否必须	数据类型
productKey	产品productKey	true	string
deviceName	设备唯一标识	true	string
firmwareId	目标固件id	true	long

响应参数：data 为 boolean。升级指令经 MQTT 下发到设备，进度与结果见批次设备状态（OTA 升级）。