增加设备模型通知
典型场景
第三方应用在物联网平台订阅了设备模型增加通知后(订阅的通知类型为deviceModelAdded),在物联网平台上新增设备Profile文件时,平台会向第三方应用推送通知消息。
接口功能
支持物联网平台向订阅了设备模型增加通知的第三方应用推送通知消息。
注意事项
- 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。
- 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。
- 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考IoT平台北向API参考中的消息推送章节。
接口描述
回调地址 |
https://server:port/v1.0.0/messageReceiver |
---|---|
回调接口 |
def handleDeviceModelAdded(self) |
接口所属类 |
PushMessageReceiver |
参数说明
入参是request.json
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
ndmaDTO |
必选 |
NotifyDeviceModelAddedDTO |
body |
见下表NotifyDeviceModelAddedDTO的描述。 |
NotifyDeviceModelAddedDTO
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
notifyType |
必选 |
String |
body |
通知类型,取值:“deviceModelAdded”。 |
appId |
必选 |
String |
body |
第三方应用的身份标识,用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。 |
deviceType |
必选 |
String |
body |
设备的类型。 |
manufacturerName |
必选 |
String |
body |
增加设备模型的操作者名称。 |
manufacturerId |
必选 |
String |
body |
增加设备模型的操作者ID。 |
model |
必选 |
String |
body |
设备型号。 |
protocolType |
必选 |
String |
body |
设备使用的协议类型,当前支持的协议类型:CoAP,huaweiM2M,Z-Wave,ONVIF,WPS,Hue,WiFi,J808,Gateway,ZigBee,LWM2M。 |
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl} Header: Content-Type:application/json Body: { "notifyType":"deviceModelAdded", "appId":"*****", "deviceType":"*************", "manufacturerName":"wulian", " manufacturerId ":"*************", "model":"*************", "protocolType":"zigbee" }
响应示例
response: Status Code: 200 OK