DeviceService结构体说明:
参数 必选/可
选 类型 位置 描述
serviceId 必选 String body 服务ID。
serviceTyp
e 必选 String body 服务的类型。
data 必选 ObjectNo
de body 服务数据信息。
eventTim
e 必选 String body 时间发生时间,时间格式
yyyymmddThhmmssZ,例如
“20151212T121212Z”。
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl}
Header:
Content-Type:application/json Body:
{ "notifyType":"deviceDataChanged", "requestId":"*************",
"deviceId":"********************************", "gatewayId":"*************",
"service":{
"serviceId":"Brightness",
},
"eventTime":"20170311T163657Z"
} }
正常响应示例
response:
Status Code: 200 OK
4.3.7.5 批量设备数据变化通知
典型场景
第三方应用在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为
deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向第三方应用 推送通知消息。
接口功能
支持物联网平台向订阅了设备数据批量变化通知的第三方应用推送通知消息。
注意事项
1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的 server与port为应用服务器公网地址与服务器配置中指定的端口。
2. 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。
3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调 接口,接口内容请参考物联网平台API参考中的消息推送章节。
接口描述
回调地址 https://server:port/v1.0.0/messageReceiver 回调接口 def handleDeviceDatasChanged(self) 接口所属类 PushMessageReceiver
参数说明
入参是request.json
参数 必选/可
选
类型 位置 描述
nddscDTO 必选 NotifyDevic eDatasCha ngedDTO
body 见下表
NotifyDeviceDatasChangedDT O的描述。
NotifyDeviceDatasChangedDTO
参数 必选/可 选
类型 位置 描述
notifyTyp
e 必选 String body 通知类型,取值:
“deviceDatasChanged”。
requestId 必选 String body 消息的序列号,唯一标识该消息。
deviceId 必选 String body 设备ID,用于唯一标识一个设备。
gatewayId 必选 String body 网关ID,用于唯一标识一个网关设 备。
services 必选 List<Devic
eService> body 服务列表信息,具体参见
DeviceService结构体说明。
DeviceService结构体说明:
参数 必选/可
选
类型 位置 描述
serviceId 必选 String body 服务ID。
serviceTyp
e 必选 String body 服务类型。
data 必选 ObjectNo
de body 服务数据信息。
eventTim
e 必选 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":{
}, {
"serviceId":"Color", "serviceType":"Color", "data":{
"value":"red"
},
"eventTime":"20170311T163657Z"
} ] }
正常响应示例
response:
Status Code: 200 OK
4.3.7.6 设备服务信息变化通知
典型场景
第三方应用在物联网平台订阅了设备服务信息变化通知后(订阅的通知类型为 serviceInfoChanged),当平台向设备下发命令修改设备服务信息时,平台会向第三 方应用推送通知消息。
接口功能
支持物联网平台向订阅了设备服务信息变化通知的第三方应用推送通知消息。
注意事项
1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的 server与port为应用服务器公网地址与服务器配置中指定的端口。
2. 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。
3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调 接口,接口内容请参考物联网平台API参考中的消息推送章节。
接口描述
回调地址 https://server:port/v1.0.0/messageReceiver 回调接口 def handleServiceInfoChanged(self) 接口所属类 PushMessageReceiver
参数说明
入参是request.json
参数 必选/可 选
类型 位置 描述
nsicDTO 必选 NotifyServi ceInfoChan gedDTO
body 见下表
NotifyServiceInfoChangedDTO 的描述。
NotifyServiceInfoChangedDTO
参数 必选/可
选
类型 位置 描述
notifyTyp
e 必选 Enum body 通知类型,取值:
“serviceInfoChanged”。
deviceId 必选 String body 设备ID,用于唯一标识一个设备。
gatewayI
d 必选 String body 网关ID,用于唯一标识一个网关设 备。
serviceId 必选 String body 设备服务标识。
serviceTy
pe 必选 String body 设备服务类型。
serviceInf
o 必选 ServiceInf
o body 设备服务信息,增量上报,具体参
见ServiceInfo结构体。
ServiceInfo结构体说明:
参数 必选/可选 类型 位置 描述
muteCm
ds 可选 List<String
> body 屏蔽的设备控制命令列表。
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl}
Header:
Content-Type:application/json Body:
{ "notifyType":"serviceInfoChanged", "deviceId":"*******",
"serviceId":"*******",
"muteCmds":"VIDEO_RECORD"
} }
正常响应示例
response:
Status Code: 200 OK
4.3.7.7 删除设备通知
典型场景
第三方应用在物联网平台订阅了删除设备通知后(订阅的通知类型为
deviceDeleted),当设备在物联网平台中被删除后,平台会向第三方应用推送通知消 息。
接口功能
支持物联网平台向订阅了删除设备通知的第三方应用推送通知消息。
注意事项
1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的 server与port为应用服务器公网地址与服务器配置中指定的端口。
2. 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。
3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调 接口,接口内容请参考物联网平台API参考中的消息推送章节。
接口描述
回调地址 https://server:port/v1.0.0/messageReceiver 回调接口 def handleDeviceDeleted(self)
接口所属类 PushMessageReceiver
参数说明
入参是request.json
参数 必选/可
选
类型 位置 描述
nddDTO 必选 NotifyDevic eDeletedDT O
body 见下表
NotifyDeviceDeletedDTO的描 述。
NotifyDeviceDeletedDTO
参数 必选/可选 类型 位置 描述 notifyTyp
e 必选 String body 通知类型,取值:
“deviceDeleted”。
deviceId 必选 String body 设备ID,用于唯一标识一个设 备。
gatewayId 必选 String body 网关ID,用于唯一标识一个网关 设备。
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl}
Header:
Content-Type:application/json Body:
{ "notifyType":"deviceDeleted", "deviceId":"********************************", "gatewayId":"*************"
}
正常响应示例
response:
Status Code: 200 OK
4.3.7.8 设备消息确认通知
典型场景
第三方应用在物联网平台订阅了设备消息确认通知后(订阅的通知类型为
messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命 令已送达、已执行等)时,平台会向第三方应用推送通知消息。
接口功能
支持物联网平台向订阅了设备消息确认通知的第三方应用推送通知消息。
注意事项
1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的 server与port为应用服务器公网地址与服务器配置中指定的端口。
2. 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。
接口描述
回调地址 https://server:port/v1.0.0/messageReceiver 回调接口 def handleMessageConfirm(self)
接口所属类 PushMessageReceiver
参数说明
入参是request.json
参数 必选/可
选
类型 位置 描述
nmcDTO 必选 NotifyMess ageConfirm DTO
body 见下表
NotifyMessageConfirmDTO的 描述。
NotifyMessageConfirmDTO 参数 必选/可
选
类型 位置 描述
notify
Type 必选 String body 通知类型,取值: