V2.5 Report Device Firmware Version¶
上报设备固件版本。
请求格式¶
GET https://{apigw-address}/connect-service/v2.5/devices?action=reportFirmwareVersion
请求参数(URI)¶
名称 | 位置(Path/Query) | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|---|
orgId | Query | 必需 | String | 资产所属的组织 ID。如何获取 orgId 信息>> |
请求参数(Body)¶
名称 | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|
version | 必需 | String | 固件版本号。 |
assetId | 必需 | String | 资产ID。 |
productKey | 必需 | String | 设备的 product key。 |
deviceKey | 必需 | String | Device Key。 |
响应参数¶
名称 | 数据类型 | 描述 |
---|---|---|
code | number | 更新成功或失败的指示码。 |
msg | String | 成功时返回 OK ;其他值则为失败。 |
requestId | String | 每次请求获取的 ID,用于唯一标识一次 API 请求。 |
错误码¶
代码 | 错误信息 | 描述 |
---|---|---|
400 | Invalid Argument | 参数错误。 |
500 | OTA Service Internal Error | OTA 服务内部错误。 |
404 | Device Not Found | 设备未找到。 |