文档首页 > > API参考> 应用侧JAVA SDK API参考> 消息推送> 固件升级状态变更通知

固件升级状态变更通知

分享
更新时间: 2019/11/12 GMT+08:00

典型场景

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

接口功能

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

注意事项

1. 应用在订阅平台管理数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口

2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容

3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考物联网平台API参考中的消息推送章节。

接口描述

回调地址

https://server:port/v1.0.0/messageReceiver

回调接口

void handleFwUpgradeStateChanged(NotifyFwUpgradeStateChangedDTO body)

接口所属类

PushMessageReceiver

参数说明

NotifyFwUpgradeStateChangedDTO

参数

必选/可选

类型

位置

描述

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
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区