更新时间:2022-02-24 GMT+08:00
设备影子状态变更通知
典型场景
应用服务器在物联网平台订阅了设备影子状态变更通知后(订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged),当平台中的设备影子向设备同步数据成功或失败时,平台会向应用服务器推送通知消息。
接口功能
支持物联网平台向订阅了设备影子状态变更通知的应用服务器推送通知消息。
注意事项
应用收到推送消息,请务必返回响应码。
接口原型
请求方法 |
POST |
---|---|
请求地址 |
由应用服务器订阅请求消息中的callbackurl决定。 |
传输协议 |
HTTPS/HTTP |
请求参数
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
notifyType |
必选 |
String |
body |
通知类型,取值:deviceDesiredPropertiesModifyStatusChanged。 |
deviceId |
必选 |
String |
body |
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 |
serviceId |
必选 |
String |
body |
服务ID,用于标识一个服务。 |
properties |
必选 |
ObjectNode |
body |
设备影子数据属性 |
status |
必选 |
String |
body |
状态,取值DELIVERED/FAILED。 |
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl} Header: Content-Type: application/json Body: { "notifyType": "deviceDesiredPropertiesModifyStatusChanged", "deviceId": "******", "serviceId": "Device", "properties": { "Model Number": 1, "Serial Number": 2, "Firmware Version": "v1.1.0" }, "status": "DELIVERED" }
响应示例
response: Status Code: 200 OK
父主题: 推送通知