Help Center> IoT Device Access> API Reference> 设备侧MQTT接口参考> 网关与子设备管理> 网关同步子设备列表
View PDF

网关同步子设备列表

功能介绍

网关设备从平台同步子设备列表。网关设备不在线时，平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时，可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过平台通知网关子设备新增接口通知网关设备，删除的子设备信息会通过平台通知网关子设备删除通知网关设备。

Topic

上行: $oc/devices/{device_id}/sys/events/up

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

事件对应的最终目标设备，没有携带则表示目标设备即topic中指定的设备

services

可选

List<EventService>

事件服务列表

EventService定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

$sub_device_manager

event_type

必选

String

sub_device_sync_request

event_time

可选

String

事件时间

paras

必选

Object

事件参数JSON对象

paras参数列表

字段名

必选/可选

类型

参数描述

version

可选

Long

子设备信息版本。网关设备收到的最近一次的子设备新增或删除通知时的子设备版本信息。平台会根据此版本信息将此版本后新增或者删除的子设备信息通知给网关设备。

示例

Topic: $oc/devices/{device_id}/sys/events/up
数据格式：   
{
	"object_device_id": "{object_device_id}",
	"services": [{
		"service_id": "$sub_device_manager",
		"event_type": "sub_device_sync_request",
		"event_time": "20151212T121212Z",
		"paras": {"version": 1}
	}]
}