正常响应示例
4.3.7.3 设备信息变化通知
}
正常响应示例
response:
Status Code: 200 OK
4.3.7.3 设备信息变化通知
典型场景
第三方应用在物联网平台订阅了设备信息变化通知后（订阅的通知类型为
deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本 信息、在线状态信息等）发生变化时，平台会向第三方应用推送通知消息。
接口功能
支持物联网平台向订阅了设备信息变化通知的第三方应用推送通知消息。
注意事项
1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址，回调地址中的 server与port为应用服务器公网地址与服务器配置中指定的端口。
2. 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。
3. 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调 接口，接口内容请参考物联网平台API参考中的消息推送章节。
接口描述
回调地址 https://server:port/v1.0.0/messageReceiver 回调接口 def handleDeviceInfoChanged(self) 接口所属类 PushMessageReceiver
参数说明
入参是request.json
参数 必选/可 选
类型 位置 描述
ndicDTO 必选 NotifyDevic eInfoChang edDTO
body 见下表
NotifyDeviceInfoChangedDTO 的描述。
NotifyDeviceInfoChangedDTO
参数 必选/可选 类型 位置 描述
notifyTy
pe 必选 String body 通知类型，取值：
“deviceInfoChanged”。
deviceId 必选 String body 设备ID，用于唯一标识一个设备。
gateway
Id 必选 String body 网关ID，用于唯一标识一个网关设备。
deviceIn
fo 必选 DeviceI
nfo body 设备信息，具体参见DeviceInfo结构 体。
DeviceInfo结构体说明：
参数 必选/
可选
类型 位置 描述
nodeId 必选 String(256
) body 设备的唯一标识，通常使用MAC，MAC 地址，Serial No或IMEI作为nodeId。
说明若使用IMEI作为nodeId，根据不同厂家的芯 片有不同填写要求。
● 高通芯片设备的唯一标识为 urn:imei:xxxx，xxxx为IMEI号
● 海思芯片设备的唯一标识为IMEI号
● 其他厂家芯片的设备唯一标识请联系模组 厂家确认。
name 可选 String(256
) body 设备名称。
descripti
on 可选 String(204
8) body 设备的描述信息。
manufa
cturerId 可选 String(256
) body 厂商ID，唯一标识一个厂商。
manufa 可选 String(256 body 厂商名称。
参数 必选/
可选
类型 位置 描述
mac 可选 String(256
) body 设备的MAC地址。
location 可选 String(204
8) body 设备的位置信息。
deviceTy
pe 可选 String(256
) body 设备类型，大驼峰命名方式，如 MultiSensor、ContactSensor、
CameraGateway。
model 可选 String(256
) body 设备的型号。
swVersi
on 可选 String(256
) body 设备的软件版本。
Z-Wave：主版本号.次版本号，如：1.1。
fwVersio
n 可选 String(256
) body 设备的固件版本。
hwVersi
on 可选 String(256
) body 设备的硬件版本。
protocol
Type 可选 String(256
) body 设备使用的协议类型，当前支持的协议类 型：CoAP，huaweiM2M，Z-Wave，
ONVIF，WPS，Hue，WiFi，J808，
Gateway，ZigBee，LWM2M。
bridgeId 可选 String(256
) body Bridge标识，表示设备通过哪个Bridge接 入物联网平台。
status 可选 String body 设备的状态，表示设备是否在线，取值范 围：“ONLINE”、“OFFLINE”、
“ABNORMAL”。
statusD
etail 可选 String(256
) body 设备的状态详情，status条件取值，取值 查看status和statusDetail。
参数 必选/
可选
类型 位置 描述
signalStr
ength 可选 String(256
) body 设备的信号强度。
sigVersi
on 可选 String(256
) body 设备的sig版本。
serialNu
mber 可选 String(256
) body 设备的序列号。
batteryL
evel 可选 String(256
) body 设备的电池电量。
status和statusDetail：
status statusDetail
OFFLINE NONE CONFIGURATION_PENDING ONLINE NONE COMMUNICATION_ERROR
CONFIGURATION_ERROR BRIDGE_OFFLINE FIRMWARE_UPDATING DUTY_CYCLE NOT_ACTIVE
说明
设备向物联网平台上报设备状态时需要status、statusDetail成对上报。statusDetail建议仅用作 显示，不建议用于逻辑判断。
响应参数
Status Code: 200 OK
请求示例
Method: POST request: {callbackUrl}
Header:
Content-Type:application/json Body:
{ "notifyType ":"deviceInfoChanged", "deviceId":"********************************", "gatewayId":"*************",
"deviceInfo":{
"name":"Sensor_12", "manufacturer":"wulian", "type":90,
"model":"90", "mac":"****************", "swVersion":"…", "fwVersion":"…",
} }
正常响应示例
response:
Status Code: 200 OK