更新时间:2022-02-24 GMT+08:00

增加设备模型通知

典型场景

第三方应用在物联网平台订阅了设备模型增加通知后(订阅的通知类型为deviceModelAdded),在物联网平台上新增设备Profile文件时,平台会向第三方应用推送通知消息。

接口功能

支持物联网平台向订阅了设备模型增加通知的第三方应用推送通知消息。

注意事项

  1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。
  2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容。
  3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考IoT平台北向API参考中的消息推送章节。

接口描述

回调地址

https://server:port/v1.0.0/messageReceiver

回调接口

function handleDeviceModelAdded(NotifyDeviceModelAddedDTO $body)

接口所属类

PushMessageReceiver

参数说明

NotifyDeviceModelAddedDTO

参数

必选/可选

位置

描述

$notifyType

必选

body

通知类型,取值:“deviceModelAdded”

$appId

必选

body

第三方应用的身份标识,用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。

$deviceType

必选

body

设备的类型。

$manufacturerName

必选

body

增加设备模型的操作者名称。

$manufacturerId

必选

body

增加设备模型的操作者ID。

$model

必选

body

设备型号。

$protocolType

必选

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