Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 订阅管理-V5> 推送通知> 设备激活通知
View PDF

设备激活通知

接口说明

应用服务器在物联网平台订阅了设备激活通知后（订阅的资源为device，事件为activate），当设备首次接入物联网平台并激活时，平台会向应用服务器推送通知消息。

注意事项

应用服务器收到推送消息时，请务必返回响应码。

URI

请求方法

POST

URI

由应用服务器订阅设备激活通知中的callbackUrl决定

传输协议

HTTPS/HTTP

请求参数

名称

必选/可选

类型

位置

说明

resource

必选

String

Body

订阅的资源名称，取值为device。

event

必选

String

Body

订阅的资源事件，取值为activate。

notify_data

必选

deviceActivate Object

Body

设备的自定义字段列表。
表1 deviceActivate

名称

必选/可选

类型

说明

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

设备节点类型。

  • ENDPOINT：非直连设备。
  • GATEWAY：直连设备或网关。
  • UNKNOWN：未知。

description

可选

String

设备的描述信息。

product_info

可选

ProductInfo Object

设备关联的产品模型信息。
表2 ProductInfo

名称

必选/可选

类型

说明

product_id

可选

String

设备关联的产品ID，用于唯一标识一个产品模型。

device_type

可选

String

设备类型，在设备关联的产品模型中定义。

manufacturer_id

可选

String

厂商ID，在设备关联的产品模型中定义。

manufacturer_name

可选

String

厂商名称，在设备关联的产品模型中定义。

model

可选

String

设备型号，在设备关联的产品模型中定义。

protocol_type

可选

String

设备使用的协议类型，在设备关联的产品模型中定义。

请求示例

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

父主题： 推送通知