更新时间:2023-04-13 GMT+08:00
分享

设备激活通知

接口说明

应用服务器在物联网平台订阅了设备激活通知后(订阅的资源为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

相关文档