文档首页/ IoT物联网/ API参考/ 应用侧API参考（联通用户专用）/ 订阅管理-V3/ 推送通知/ 固件升级状态变更通知
更新时间：2023-04-13 GMT+08:00
查看PDF
分享

固件升级状态变更通知

接口说明

应用服务器在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。

注意事项

应用收到推送消息，请务必返回响应码。

URI

请求方法

POST

URI

由应用服务器订阅请求消息中的callbackurl决定。

传输协议

HTTPS/HTTP

请求参数

参数

必选/可选

类型

位置

描述

notifyType

必选

String

body

通知类型，取值：fwUpgradeStateChangeNotify。

deviceId

必选

String

body

设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。

appId

必选

String

body

设备所属应用的应用ID。

operationId

必选

String

body

固件升级任务ID。

subOperationId

必选

String

body

固件升级子任务ID。

step

必选

String

body

固件升级状态。

stepDesc

必选

String

body

升级状态描述。

  • otacreated：升级任务已启动
  • RequestDownload： 设备请求下载包
  • downloading：设备正在下载软件包
  • downloaded：设备下载软件包完成
  • updating：设备正在进行升级
  • idle：设备处于空闲状态

响应参数

Status Code: 200 OK

请求示例

POST {callbackUrl}
Content-Type: application/json

{
  "notifyType": "fwUpgradeStateChangeNotify",
  "deviceId": "******",
  "appId": "***********",
  "operationId": "**************",
  "subOperationId": "***********",
  "step": "downloading",
  "stepDesc": "downloading"
}

正常响应示例

Status Code: 200 OK
父主题： 推送通知

相关文档