物联感知平台接入Topic对应业务参数及开发指南、JSON格式转换、设备属性应用、请求URI、鉴权认证示例

DB5120/T 29.3—2024 10 附录A （资料性） Topic 对应的业务参数及开发指南 A.1 Topic对应的业务参数及开发指南应符合表A.1规则 举例：资阳市雁江区住建局互联网扬尘检测点位：中心编码（资阳市雁江区641300、基层接入单位 暂定00）、行业编码（环境接入11）、类型编码（扬尘检测感知终端600）、网络标识（Internet网7）、 基层分类（00）、序号（第一台0001），因此编码应为64130000116007000001。 表A.1Topic对应的业务参数 主题（Topic） 分类 主题 Topic 生产者 Publisher 订阅者 Subscriber 用途 设备消息相关 Topic $oc/devices/{device_id}/sys/messag es/up 设备平台设备消息上报 $oc/devices/{device_id}/sys/messag es/down 平台设备 平台下发消息给设 备 设备命令相关 Topic $oc/devices/{device_id}/sys/comma nds/request_id={request_id} 平台设备 平台下发命令给设 备 $oc/devices/{device_id}/sys/comma nds/response/request_id={request_i d} 设备平台设备返回命令响应 设备属性相关 Topic $oc/devices/{device_id}/sys/properti es/report 设备平台设备上报属性数据 $oc/devices/{device_id}/sys/gateway /sub_devices/properties/report 设备平台 网关批量上报属性 数据 $oc/devices/{device_id}/sys/properti es/set/request_id={request_id} 平台设备平台设置设备属性 $oc/devices/{device_id}/sys/properti es/set/response/request_id={request _id} 设备平台 属性设置的响应结 果 $oc/devices/{device_id}/sys/properti es/get/request_id={request_id} 平台设备平台查询设备属性 $oc/devices/{device_id}/sys/properti es/get/response/request_id={request _id} 设备平台 属性查询响应结 果，这个结果不会 对设备属性和影子 产生影响 $oc/devices/{device_id}/sys/shadow/ get/request_id={request_id} 设备平台 设备侧主动获取平 台的设备影子数据 DB5120/T 29.3—2024 11 （续）表A.1Topic对应的业务参数 主题（Topic） 分类 主题 Topic 生产者 Publisher 订阅者 Subscriber 用途 设备属性相关 Topic $oc/devices/{device_id}/sys/shadow/ get/response/request_id={request_i d} 平台设备 设备侧主动获取平 台设备影子数据的 响应 设备事件相关 Topic $oc/devices/{device_id}/sys/events/ up 设备平台设备事件上报 $oc/devices/{device_id}/sys/events/ down 平台设备平台事件下发 DB5120/T 29.3—2024 12 附录B （资料性） JSON 格式转换示例 B.1 示例 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联感知平台通信 时，可将原始二进制数据透传到物联感知平台。通过开发编解码插件实现二进制数据到平台定义JSON 格式的转换。 Topic 下行： $oc/devices/{device_id}/sys/commands/request_id={request_id} 上行： $oc/devices/{device_id}/sys/commands/response/request_id={request_id} {request_id}用于唯一标识这次请求。设备侧收到下行请求的topic带该参数时，上行响应的topic需要 将该参数值返回给平台。 设备侧订阅带{request_id}结尾的topic时，可以使用通配#，设备侧订阅平台命令下发的topic为： $oc/devices/{device_id}/sys/commands/# 下行请求参数说明 字段名必选/可选类型参数描述 object_device_id可选String 命令对应的目标设备 ID， 命令下发对应的最终目标设备， 没有携带则表示目标设备即 topic 中指定的设备。 service_id可选String设备的服务 ID，在设备关联的产品模型中定义 command_name可选String设备命令名称，在设备关联的产品模型中定义。 paras可选Object 设备命令的执行参数，具体字段在设备关联的产品模型 中定义。 上行响应参数说明 命令应答的json格式，具体字段在设备关联的产品模型中定义。 字段名必选/可选类型参数描述 result_code可选Integer 标识命令的执行结果，0 表示成功，其他表示失败。不带默 认认为成功。 response_name可选String命令的响应名称，在设备关联的产品模型中定义。 paras可选Object命令的响应参数，具体字段在设备关联的产品模型中定义。 下行请求示例 Topic: $oc/devices/{device_id}/sys/commands/request_id={request_id} 数据格式： { “object_device_id“: “{object_device_id}“, “command_name“: “ON_OFF“, “service_id“: “WaterMeter“, “paras“: { “value“: “1“ DB5120/T 29.3—2024 13 } } 上行响应示例 Topic：$oc/devices/{device_id}/sys/commands/response/request_id={request_id} 数据格式： { “result_code“: 0, “response_name“: “COMMAND_RESPONSE“, “paras“: { “result“: “success“ } } DB5120/T 29.3—2024 14 附录C （资料性） 设备属性应用示例 C.1 示例 a）设备属性上报：用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上 报的区别，请查看消息通信说明。 说明：低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联感知平 台通信时， 可将原