更新时间:2023-04-13 GMT+08:00
分享

固件升级状态变更通知

接口说明

应用服务器在物联网平台订阅了固件升级状态变更通知后(订阅的通知类型为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
分享:

    相关文档

    相关产品