设备激活通知
接口说明
应用服务器在物联网平台订阅了设备激活通知后(订阅的资源为device,事件为activate),当设备首次接入物联网平台并激活时,平台会向应用服务器推送通知消息。
注意事项
应用服务器收到推送消息时,请务必返回响应码。
URI
请求方法 |
POST |
---|---|
URI |
由应用服务器订阅设备激活通知中的callbackUrl决定 |
传输协议 |
HTTPS/HTTP |
请求参数
名称 |
必选/可选 |
类型 |
位置 |
说明 |
---|---|---|---|---|
resource |
必选 |
String |
Body |
订阅的资源名称,取值为device。 |
event |
必选 |
String |
Body |
订阅的资源事件,取值为activate。 |
notify_data |
必选 |
deviceActivate Object |
Body |
设备的自定义字段列表。 |
名称 |
必选/可选 |
类型 |
说明 |
---|---|---|---|
app_id |
可选 |
String |
应用ID |
device_id |
可选 |
String |
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 |
node_id |
可选 |
String |
设备标识码,通常使用IMEI、MAC地址或Serial No作为nodeId。 |
gateway_id |
可选 |
String |
网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。 |
device_name |
可选 |
String |
设备名称。 |
node_type |
可选 |
String |
设备节点类型。
|
description |
可选 |
String |
设备的描述信息。 |
product_info |
可选 |
ProductInfo Object |
设备关联的产品模型信息。 |
请求示例
POST 由应用服务器订阅设备激活通知中的callbackUrl决定 Content-Type: application/json { "resource" : "string", "event" : "string", "notify_data" : { "device_name" : "dianadevice", "node_type" : "ENDPOINT", "device_id" : "d4922d8a-6c8e-4396-852c-164aefa6638f", "description" : "watermeter device", "product_info" : { "protocol_type" : "CoAP", "manufacturer_id" : "TestUtf8ManuId", "product_id" : "b640f4c203b7910fc3cbd446ed437cbd", "device_type" : "WaterMeter", "model" : "TestUtf8Model", "manufacturer_name" : "HZYB" }, "app_id" : "d4922d8a-6c8e-4396-852c-164aefa6638f", "gateway_id" : "d4922d8a-6c8e-4396-852c-164aefa6638f", "node_id" : "ABC123456789" } }
响应示例
Status Code: 200 OK