文档首页/ 智能设施云平台/ 开发指南/ 南向设备接入/ MQTT/MQTTS接入方案/ 设备侧MQTT/MQTTS接口参考/ 网关与子设备管理/ 网关同步子设备列表
更新时间：2025-08-19 GMT+08:00
查看PDF
分享

网关同步子设备列表

功能介绍

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

Topic

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

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释：

该参数目前暂未实装使用，无需填写。

services

可选

List<EventService>

参数解释：

事件服务列表。

EventService定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释：

系统字段。

取值范围：

固定为："$sub_device_manager"。

event_type

必选

String

参数解释：

系统字段。

取值范围：

固定为："sub_device_sync_request"。

event_time

可选

String

参数解释：

事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。

设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。

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}
	}]
}

相关文档