Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 订阅管理-V3> 推送通知> 软件升级状态变更通知
View PDF

软件升级状态变更通知

接口说明

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

注意事项

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

URI

请求方法

POST

URI

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

传输协议

HTTPS/HTTP

请求参数

参数

必选/可选

类型

位置

描述

notifyType

必选

String

body

通知类型，取值：swUpgradeStateChangeNotify。

deviceId

必选

String

body

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

appId

必选

String

body

设备所属应用的应用ID。

operationId

必选

String

body

软件升级任务ID。

subOperationId

必选

String

body

软件升级子任务ID。

swUpgradeState

必选

String

body

软件升级状态。

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

响应参数

Status Code: 200 OK

请求示例

POST {callbackUrl}
Content-Type: application/json

{
  "notifyType": "swUpgradeStateChangeNotify",
  "deviceId": "******",
  "appId": "***********",
  "operationId": "***********",
  "subOperationId": "***********",
  "swUpgradeState": "downloading"
}

正常响应示例

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