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

DB5120/T 29.32024 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.32024 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.32024 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.32024 13 } } 上行响应示例 Topicoc/devices/{device_id}/sys/commands/response/request_id{request_id} 数据格式 { “result_code“ 0, “response_name“ “COMMAND_RESPONSE“, “paras“ { “result“ “success“ } } DB5120/T 29.32024 14 附录C （资料性） 设备属性应用示例 C.1 示例 a）设备属性上报用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上 报的区别，请查看消息通信说明。 说明低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联感知平 台通信时， 可将原