网关新增子设备请求响应

功能介绍

平台将该网关新增的子设备列表信息通知给网关设备，平台收到网关新增子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。

Topic

下行: $oc/devices/{device_id}/sys/events/down

参数说明

字段名	必选/可选	类型	参数描述
object_device_id	可选	String	参数解释：该参数与Topic中的device_id一致。
services	可选	List<ServiceEvent>	参数解释：事件服务列表。

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释：

该参数与Topic中的device_id一致。

services

可选

List<ServiceEvent>

参数解释：

事件服务列表。

ServiceEvent定义表

字段名	必选/可选	类型	参数描述
service_id	必选	String	参数解释：系统字段。取值范围：固定为："$sub_device_manager"。
event_type	必选	String	参数解释：系统字段。取值范围：固定为："add_sub_device_response"。
event_time	可选	String	参数解释：事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。
event_id	必选	String	参数解释：事件请求Id，通过该参数关联对应的事件请求。
paras	必选	Object	参数解释：事件参数JSON对象。

paras参数列表

字段名	必选/可选	类型	参数描述
successful_devices	必选	List<DeviceInfo>	参数解释：成功新增的子设备列表详情。
failed_devices	必选	List<Reason>	参数解释：新增子设备失败的原因。

字段名

必选/可选

类型

参数描述

successful_devices

必选

List<DeviceInfo>

参数解释：

成功新增的子设备列表详情。

failed_devices

必选

List<Reason>

参数解释：

新增子设备失败的原因。

DeviceInfo定义表

字段名	必选/可选	类型	参数描述
parent_device_id	必选	String	参数解释：父节点设备ID。
node_id	必选	String	参数解释：设备标识。
device_id	必选	String	参数解释：设备ID。
name	可选	String	参数解释：设备名称。
description	可选	String	参数解释：设备描述。
manufacturer_id	可选	String	参数解释：厂商ID。
model	可选	String	参数解释：设备型号。
product_id	可选	String	参数解释：产品ID。
fw_version	可选	String	参数解释：固件版本。
sw_version	可选	String	参数解释：软件版本。
status	可选	String	参数解释：设备在线状态。取值范围： ONLINE：设备在线。 OFFLINE：设备离线。 INACTIVE：设备未激活。
extension_info	可选	Object	参数解释：设备扩展信息。用户可以自定义任何想要的扩展信息。

Reason定义表

字段名	必选/可选	类型	参数描述
node_id	必选	String	参数解释：对应请求中指定的设备的node_id。
product_id	必选	String	参数解释：对应请求中指定的设备的product_id。
error_code	必选	String	参数解释：新增失败错误原因码。
error_msg	必选	String	参数解释：新增失败原因描述。

示例

Topic: $oc/devices/{device_id}/sys/events/down  
数据格式： 
{
  "object_device_id": "{object_device_id}",
  "services": [
    {
      "service_id": "$sub_device_manager",
      "event_type": "add_sub_device_response",
      "event_time": "20151212T121212Z",
      "event_id": "40cc9ab1-3579-488c-95c6-c18941c99eb4",
      "paras": {
          "successful_devices": [
          {
            "device_id": "c6b39067b0325db34663d3ef421a42f6_subdevice11",
            "name": "subdevice11",
            "node_id": "subdevice11",
            "product_id": "c6b39067b0325db34663d3ef421a42f6",
            "description": "subdevice11",
            "manufacturer_id": "ofo",
            "model": "twx2",
            "fw_version": null,
            "sw_version": null,
            "status": "ONLINE",
            "extension_info" : null,
            "parent_device_id" : null
          }
        ],
        "failed_devices": [
          {
            "node_id": "subdevice12",
            "product_id": "c6b39067b0325db34663d3ef421a42f6",
            "error_code": "XXX",
            "error_msg": "XXXX"
          }
        ]
 
      }
    }
  ]
}

父主题：网关与子设备管理

上一篇：网关新增子设备请求

下一篇：网关删除子设备请求