方案名称： 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. 应用层
物业管理系统、智慧园区平台、工地实名制平台、校园一卡通、医院安防平台、政企管理平台、自助经营计费系统、企业微信/钉钉等。
| 能力 | 协议/接口 | 典型用途 |
|---|---|---|
| 实时状态 | MQTT | 在线/离线、门开/门关、故障告警 |
| 远程指令 | MQTT | 远程开门、锁门、消防释放、重启 |
| 事件订阅 | MQTT/Webhook | 刷卡、人脸、访客、异常开门 |
| 通行记录 | RESTful API | 查询、导出、增量拉取 |
| 人员权限 | RESTful API | 批量下发、回收、分组授权 |
| 设备管理 | RESTful API | 参数配置、OTA、版本管理 |
| 访客授权 | RESTful API | 临时密码、二维码、时效管理 |
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. 渠道商与集成商
将中优设备作为标准组件集成进自有方案，缩短交付周期。一套对接，多项目复用，降低边际交付成本。
| 对比项 | 传统封闭协议常见情况 | 中优云联开放协议 |
|---|---|---|
| 协议授权费 | 2-10万/项目 | 标准接口对接不额外收取接口授权费 |
| 定制开发费 | 3-8万 | 标准API直接调用无额外费用，定制开发另议 |
| 对接周期 | 4-8周 | 简单场景通常3-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中优云联，全线开放，欢迎接入。