固件升级结果通知
接口说明
应用服务器在物联网平台订阅了固件升级结果通知后(订阅的通知类型为fwUpgradeResultNotify),当设备的固件升级任务执行完成时,平台会向应用服务器推送通知消息。
注意事项
应用收到推送消息,请务必返回响应码。
URI
请求方法 |
POST |
---|---|
URI |
由应用服务器订阅请求消息中的callbackurl决定。 |
传输协议 |
HTTPS/HTTP |
请求参数
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
notifyType |
必选 |
String |
body |
通知类型,取值:fwUpgradeResultNotify。 |
deviceId |
必选 |
String |
body |
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 |
appId |
必选 |
String |
body |
设备所属应用的应用ID。 |
operationId |
必选 |
String |
body |
固件升级任务ID。 |
subOperationId |
必选 |
String |
body |
固件升级子任务ID。 |
curVersion |
必选 |
String |
body |
设备当前的固件版本。 |
targetVersion |
必选 |
String |
body |
设备要升级的目标固件版本。 |
sourceVersion |
必选 |
String |
body |
设备的源固件版本。 |
status |
必选 |
String |
body |
升级结果。
|
statusDesc |
必选 |
String |
body |
升级结果描述。 |
upgradeTime |
必选 |
long |
body |
固件升级时长。 |
响应参数
Status Code: 200 OK
请求示例
POST {callbackUrl} Content-Type: application/json { "notifyType": "fwUpgradeResultNotify", "deviceId": "******", "appId": "***********", "operationId": "***********", "subOperationId": "***********", "curVersion": "1.6", "targetVersion": "1.6", "sourceVersion": "1.3", "status": "SUCCESS", "statusDesc": "****", "upgradeTime": "****" }
正常响应示例
Status Code: 200 OK