适用场景

门禁对接的难点在"双方数据模型不一致"：门禁按卡号，系统按人员，访客按凭证有效期。对接方案要把这三层映射讲清楚。

配置步骤（对接协议与数据模型）

# 常见对接方式
# 1) 设备 SDK / 私有协议（厂家提供库）
# 2) 标准协议：韦根（单向）、OSDP（双向加密）、HTTP/WebSocket API
# 3) 平台级对接：门禁厂家平台提供 REST/推送
# 数据流：平台下人员+凭证 -> 门禁控制器 -> 闸机执行
# 记录流：闸机/门禁 -> 控制器 -> 平台

关键参数与建议

  • 先统一凭证模型：卡号/二维码/人脸 ID 三选一为主，其余作为补充
  • 权限下发要有确认机制（下发成功/失败回执），否则会出现"系统显示已授权但门不开"
  • 记录回传必须带时间戳与出入口标识，便于追溯
  • 门禁控制器与平台之间要留时间同步，否则记录时序错乱
  • 断电与消防联动策略必须与甲方确认（断电开还是断电闭）

容易踩的坑

  • 只用韦根单向通信，无法确认下发是否成功
  • 卡号格式未统一（十进制/十六进制/反序），导致刷不上
  • 人脸 ID 与卡号混用未做唯一性校验，出现串人

验证与巡检

# 三方联调清单：下发 -> 刷卡 -> 开门 -> 记录回传 -> 平台可查
  • 巡检：授权/撤销/记录三条链路都有回执与日志

小结

对接验收三条：授权后能开、撤销后不能开、记录能查且时间正确。这三条过了，剩下的都是优化。

> 说明：文中命令为通用写法，不同型号/版本可能略有差异，落地前请对照设备实际版本的官方文档；带外管理与安全设备变更建议先在测试设备验证。