更新时间: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 |
升级状态描述。
|
响应参数
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
父主题: 推送通知