上海市《智能物联 城市智联平台数据接口技术要求》DB31/T 1492-2024

本规范规定了上海市城市智联平台对外提供的数据接口技术要求，涵盖接口基本要求、传输要求、应用类接口及云边端协同接口等核心内容。本规范从接口分类入手，将智联平台接口划分为云边端协同接口与应用接口两大类，其中应用接口进一步细分为面向C端（一网通办）、B端（行业应用）、G端（一网统管）及开发者的四类接口，并明确了各类接口的协议选择、数据格式与安全约束。在此基础上，本规范对网络传输带宽、传输质量、可靠性及业务接口时延提出了量化指标，确保数据流转的高效与稳定。此外，本规范详细定义了应用类通用接口的认证鉴权机制，以及对接一网通办、行业应用和一网统管的特定数据交互流程与接口参数，同时系统规定了云边端协同场景下的设备注册、业务影子同步、库同步、数据同步及文件同步等通用接口，并给出了智能电梯、智能停车场等典型应用场景的协同接口示例。

接口总体框架与约束

本规范构建了以城市智联平台为核心的接口体系，涵盖云边端协同接口与应用接口两大类。云边端协同接口负责端、边、云之间的设备管理、数据同步与业务配置；应用接口则支撑平台与各类应用系统对接。所有接口须遵循统一的技术约束：消息类接口采用MQTT协议，其他接口采用RESTful风格；数据序列化优先使用JSON或ProtoBuf格式；安全层面强制要求对个人敏感数据加密、传输通道采用TLS加密，并具备AK/SK或CA证书等认证鉴权能力。

传输性能与应用对接要求

本规范从带宽、质量和时延三个维度提出硬性指标，要求智能网关与平台间业务带宽不低于100MB/s，网络时延上限400ms，丢包率上限1‰，年服务可用性不低于99.9%，消息类接口平均时延不大于2秒。在应用对接层面，本规范分别规定了一网通办场景下社区、业主、项目等数据的批量上报接口，行业应用场景下设备列表、状态及通行记录等数据的获取接口，以及一网统管场景下事件数据的交互接口，并给出了各自的交互流程与字段定义。

云边端协同通用能力

本规范针对云边端协同中的共性需求，统一规定了设备注册、业务影子同步、库同步、数据同步及文件同步五类通用接口。设备注册实现终端身份认证与上线；业务影子同步保障云端配置向边缘侧的可靠下发与状态回传；库同步支持结构化数据的全量、增量与指定范围订阅；文件同步则区分大、小文件，提供了上传与下载的标准接口定义，从而形成端-边-云数据闭环。