更新时间:2022-02-24 GMT+08:00

固件升级状态变更通知

典型场景

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

接口功能

支持物联网平台向订阅了固件升级状态变更通知的应用服务器推送通知消息。

注意事项

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

接口原型

请求方法

POST

请求地址

由应用服务器订阅请求消息中的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

固件升级状态,可取值为0、1、2、3。

stepDesc

必选

String

body

升级状态描述。

  • 1:downloading:设备正在下载软件包
  • 2:downloaded:设备下载软件包完成
  • 3:updating:设备正在进行升级
  • 0:idle:设备处于空闲状态

响应参数

Status Code: 200 OK

请求示例

Method: POST
request: {callbackUrl}
Header:
Content-Type: application/json
Body:
{
  "notifyType": "fwUpgradeStateChangeNotify",
  "deviceId": "******",
  "appId": "***********",
  "operationId": "**************",
  "subOperationId": "***********",
  "step": "1",
  "stepDesc": "downloading"
}

响应示例

response:
Status Code: 200 OK