ZUU中优云联智慧门禁开放对接解决方案：MQTT+API打通门禁与业务系统

供稿单位： 深圳市中优智能电子有限公司

方案名称： ZUU中优云联智慧门禁开放对接解决方案
适用场景： 智慧社区、智慧园区、智慧工地、校园一卡通、医院安防、政企管理平台、自助经营场所等

品牌说明： ZUU中优是品牌名，中优云联是智能门禁与出入口管理产品线（含设备、云平台与配套服务）。下文统一称“中优云联”。

方案导读

传统门禁系统在项目中常面临一个尴尬局面：设备能开门，但数据出不来；硬件装好了，却接不进甲方自有平台。

中优云联推出智慧门禁开放对接解决方案，全系列产品线开放MQTT对接协议与RESTful API接口，支持IC卡、NFC、人脸、二维码、密码等多模态通行方式（具体以产品型号为准），通过标准化协议将门禁终端数据接入物业、园区、工地、校园、医院、政务等第三方业务系统，打破信息孤岛，降低集成开发成本。

一、方案背景

随着智慧城市、智慧社区、智慧工地等场景加速落地，门禁系统已从单一出入口控制设备，逐步演变为智慧通行数据入口。但在实际集成项目中，以下问题普遍存在：

• 门禁协议封闭，接口私有化，不同品牌标准不统一；

• 二次开发周期长，定制费用高；

• 通行数据无法同步至自有平台，多套系统独立运行；

• 门禁与梯控、道闸、监控、访客、考勤等系统难以联动；

• 老旧项目改造困难，原有设备与卡片难以利旧。

中优云联开放MQTT与API对接协议，旨在以标准化、可复用的方式，解决门禁系统与第三方平台之间的连接问题。

二、方案概述

本方案以中优云联门禁终端为边缘感知节点，通过MQTT实现设备实时通信，通过RESTful API实现业务数据对接，形成“设备—云端—业务系统”三层开放架构。

核心思路：

• MQTT管设备：负责设备状态上报、远程指令下发、事件订阅、多设备联动；

• API管业务：负责通行记录查询、人员权限同步、设备管理、访客授权、Webhook事件推送；

• 统一协议：全产品线共用一套开放协议，一次开发，全设备复用。

方案可对接物业ERP、智慧园区平台、工地实名制系统、校园一卡通、医院安防平台、企业微信/钉钉、政务管理平台等第三方系统，支持公有云与私有化部署评估。

三、系统架构

1. 感知层
人脸识别门禁终端、4G云门禁、二维码门禁、多门网络控制器、二代证核验终端、AI可视对讲、梯控、道闸、出门开关等。支持IC卡、NFC、人脸、二维码、密码等通行方式，具体识别方式与频段以产品规格书为准。

2. 网络层
支持4G Cat.1、有线网络等联网方式。MQTT over TLS长连接，具备心跳保活、断线自动重连、本地缓存与断网续传能力。

3. 平台层
中优云联开放平台提供设备管理、人员权限、通行记录、事件订阅、OTA升级、系统配置等能力，并通过MQTT Broker与RESTful API向第三方系统开放。

4. 应用层
物业管理系统、智慧园区平台、工地实名制平台、校园一卡通、医院安防平台、政企管理平台、自助经营计费系统、企业微信/钉钉等。

四、核心功能

1. 设备实时通信
通过MQTT实现门禁在线/离线、门开/门关、设备温度、网络质量等状态秒级上报；支持远程开门、锁门、常开模式、消防释放、远程重启与升级。

2. 通行事件订阅
刷卡、人脸、密码、访客、异常开门、胁迫报警等事件实时推送，供第三方系统触发考勤、计费、安防联动等业务动作。

3. 人员与权限同步
人员信息、卡片、生物特征模板批量新增/修改/删除，支持增量同步，避免多处重复录入。

4. 通行记录查询
按时间、人员、设备、区域自由检索，支持分页与增量拉取，可直接落库至业务系统。

5. 访客与临时授权
第三方平台可调用接口生成临时权限、二维码或临时密码，支持时效管理。

6. 多设备联动
一台设备开门，可自动触发梯控放行、灯光开启、摄像头抓拍等联动动作。

7. 断网续传
本地缓存通行记录，网络恢复后自动补传，保障数据完整性。

五、技术特点

• 双协议开放：MQTT + RESTful API，设备连接与业务连接分离；

• 统一标准：全产品线共用一套开放协议，一次开发，全设备复用；

• 低带宽长连接：单条心跳消息仅几十字节，适配4G Cat.1等联网模组；

• 消息可靠：支持QoS 0/1/2消息等级，关键指令可靠送达；

• 安全传输：支持HTTPS、MQTT over TLS；

• 双向认证：设备端证书与云端证书双向校验；

• 签名鉴权：API Key + 请求签名，防重放攻击；

• 权限分级：支持IP白名单、管理员/运维/只读权限；

• 事件驱动：Webhook主动回调，无需轮询；

• 开发友好：Swagger在线文档、Postman测试集合、Java/Python/Node.js示例代码、沙箱环境；

• 版本兼容：协议版本向下兼容，老设备升级固件后支持新协议；

• 部署灵活：支持公有云对接，也可评估私有化部署。

六、应用场景

1. 智慧社区与物业集团
通过API同步住户信息，一次导入，全平台生效；通过MQTT订阅开门事件，同步至物业工单系统；通过API下发临时访客码，与物业APP访客预约模块打通。

2. 智慧园区与自研平台
统一纳管门禁、梯控、停车、监控等子系统，减少多品牌多平台割裂。充电桩、快递柜等社区IoT设备也可通过MQTT与门禁联动。

3. 智慧工地实名制
通行与考勤数据按监管要求直连上报，减少二次录入，降低人工录入和代打卡风险。

4. 校园一卡通与医院安防
与教务、访客、安防、基层治理平台打通，一套数据多处复用。医院可通过API对接院内安防平台，实现门禁与监控、消防、报警统一联动。

5. 政企与政务平台
与政企管理平台、基层治理平台对接，支撑人员通行数据汇总、权限统一管理与应急状态远程控制。

6. 自助经营与计费联动
健身房会员系统通过API同步会员有效期，到期自动断开门禁权限；棋牌室通过MQTT监听开门事件，实现精确计时；自习室预约平台通过API下发时段密码，预约与开门无缝衔接。

7. 渠道商与集成商
将中优设备作为标准组件集成进自有方案，缩短交付周期。一套对接，多项目复用，降低边际交付成本。

七、方案优势

注：以上为常见项目经验值，具体费用、周期与调用限制以开放平台政策及商务约定为准。

核心优势：

• 开放不封闭：标准协议对接，不做平台绑定；

• 一次开发全设备复用：全产品线统一协议，降低重复开发；

• 安全可管控：加密传输、双向认证、签名鉴权、权限分级；

• 多场景适配：社区、园区、工地、校园、医院、政企、自助经营；

• 改造灵活：支持4G无线与有线混合组网，原有锁体、存量卡片可利旧评估。

八、实施部署

Step 1｜需求沟通
说明业务场景、对接系统与所需能力，中优云联提供对接方案建议。

Step 2｜开通凭证
获取接入凭证，配置回调地址与访问限制。

Step 3｜联调测试
依据文档完成核心接口测试，跑通权限同步、记录上报、远程控制等主流程。提供沙箱环境与示例代码。

Step 4｜上线运维
切换生产环境，上线后持续提供技术支持。

九、常见问题

Q1：MQTT和API需要二选一吗？
不需要，推荐搭配使用。MQTT接收设备实时事件，API做业务管理，二者互补。

Q2：自研平台能对接吗？
可以。只要平台支持标准MQTT客户端（如EMQX、Mosquitto）或HTTP请求，即可对接。中优云联提供文档、示例代码和联调支持，不做平台限制。

Q3：对接后原有平台还能继续用吗？
可以。对接为能力叠加，不影响设备原有功能与现有管理方式。

Q4：数据安全如何保障？
API采用HTTPS加密与签名鉴权，MQTT支持TLS加密通道，数据传输双向验证身份。人脸等生物特征在设备端完成特征提取与比对，不上传原始图像，符合相关法律法规要求（具体链路以技术方案确认为准）。

Q5：对接需要额外费用吗？
标准接口对接不额外收取接口授权费；如需定制开发、私有化部署或专属技术支持，按项目另行评估报价。调用频次与限制以开放平台政策为准。

Q6：老旧设备能升级吗？
近两年推出的全系产品原生支持；部分早期设备可通过固件升级获得API能力；极早期型号建议联系技术人员评估。

Q7：数据归谁？存在哪里？
数据归属客户。公有云部署存储于中优云平台，私有化部署存储于客户自有服务器。具体以项目方案为准。

Q8：支持哪些主流平台对接？
已验证/可对接的包括企业微信、钉钉、华为云IoT、阿里云IoT、EMQX、ThingsBoard、Home Assistant等主流平台，也支持私有化自研平台对接。具体以官方清单为准。

十、关于供应商

深圳市中优智能电子有限公司深耕智能出入口管理领域，旗下ZUU中优云联产品线覆盖人脸识别门禁、4G云门禁、二维码门禁、可视对讲、多门控制器及梯控、道闸等联动外设，致力于为智慧社区、园区、工地、校园、医院、政企等场景提供稳定、开放、易集成的智慧通行解决方案。

ZUU中优云联，全线开放，欢迎接入。