设备数据批量变化通知
典型场景
应用服务器在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向应用服务器推送通知消息。
接口功能
支持物联网平台向订阅了设备数据批量变化通知的应用服务器推送通知消息。
注意事项
应用收到推送消息,请务必返回响应码。
接口原型
请求方法 |
POST |
---|---|
请求地址 |
由应用服务器订阅请求消息中的callbackurl决定。 |
传输协议 |
HTTPS/HTTP |
请求参数
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
notifyType |
必选 |
String |
body |
通知类型,取值:deviceDatasChanged。 |
requestId |
必选 |
String |
body |
消息的序列号,唯一标识该消息。 |
deviceId |
必选 |
String |
body |
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 |
gatewayId |
必选 |
String |
body |
网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。 |
services |
必选 |
List<DeviceServiceData> |
body |
服务列表信息,具体参见DeviceServiceData结构体。 |
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
serviceId |
必选 |
String |
body |
服务ID。 |
serviceType |
必选 |
String |
body |
服务类型。 |
data |
必选 |
ObjectNode |
body |
服务数据信息。 |
eventTime |
必选 |
String |
body |
事件上报时间,时间格式:yyyymmddThhmmssZ,例如20151212T121212Z。 |
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl} Header: Content-Type: application/json Body: { "notifyType": "deviceDatasChanged", "requestId": "*************", "deviceId": "********************************", "gatewayId": "*************", "service": [ { "serviceId": "Brightness", "serviceType": "Brightness", "data": { "brightness": 80 }, "eventTime": "20170311T163657Z" }, { "serviceId": "Color", "serviceType": "Color", "data": { "value": "red" }, "eventTime": "20170311T163657Z" } ] }
响应示例
response: Status Code: 200 OK