多奥智能一卡通系统接口说明：构建万物互联的智慧通行中枢

在数字化转型的浪潮中，如何打破信息孤岛，构建一个高效、安全且人性化的智慧空间，是每一位管理者面临的挑战。多奥智能一卡通系统（DAIC-YKT-PT）不仅仅是一套门禁或考勤工具，它是连接物理世界与数字世界的神经中枢。基于物联网技术，我们为学校、医院、政企、工厂及园区提供“一卡、一库、一脸、一网、一平台”的深度融合方案，旨在通过标准化的接口与强大的兼容性，将分散的硬件设施转化为统一的数据资产，助力企业实现管理的一卡通、使用的一卡通，全面迈向智慧化未来。

一、核心理念：一库一网的深度集成

多奥智能一卡通系统的核心价值在于其高度的集成性与开放性。我们深知，现代管理需要的是打破壁垒而非制造新的孤岛。因此，系统采用CPU卡（国密卡）与生物识别技术（人脸识别），确保数据传输的安全可靠。更重要的是，我们提供标准化的API接口，能够无缝接入HIS（医院信息系统）、BA（楼宇自控）、HR（人力资源）、MES（制造执行）、ERP（企业资源计划）以及AIoT平台。这意味着，无论是医院的病患管理、工厂的产线调度，还是写字楼的人员考勤，一卡通数据都能实时流转，成为企业决策的大脑，真正实现信息共享与集中控制。

二、接口规范：数据交互的通用语言

为了让开发者与管理者能够更轻松地调用系统能力，多奥智能一卡通系统（DAIC-YKT-SF）定义了一套清晰、规范的JSON数据接口标准。当任何通行事件发生时，系统将实时推送包含设备信息、用户身份、通行凭证及时间地点的全维度数据。以下是核心字段说明：

| 字段名称 | 数据类型 | 描述 |
| ------ |------ |------ |
| **deviceName** | String | 设备名称，标识具体硬件终端 |
| **deviceId** | String | 设备唯一ID，用于系统内精准定位 |
| **areaId** | Int | 所属区域ID，关联物理空间编码 |
| **areaName** | String | 所在区域名称，如“一号办公楼大堂” |
| **evValue** | Int | 事件值，用于系统逻辑判断 |
| **evName** | String | 事件名称，如“正常开门”、“非法闯入” |
| **userId** | Int | 用户ID，数据库主键索引 |
| **userNo** | String | 用户工号，关联HR或业务系统 |
| **userName** | String | 用户姓名，直观展示通行人员 |
| **accessPassport** | String | 认证凭证，支持卡号、人脸登记号、车牌号 |
| **orgName** | String | 用户所属机构名称，用于分级管理 |
| **evTime** | String | 事件时间，精确到秒的时间戳 |
| **inOut** | Int | 进出方向：1进，2出，3层（梯控专用） |
| **accessType** | Int | 通行类型：1门禁，2人脸，3车牌，4梯控 |

三、场景赋能：从通行到管理的全面升级

通过上述接口，多奥智能一卡通系统将“人性化、信息化、安全园区”的理念落到了实处。在安全层面，针对不同安全级别的区域与楼层，系统支持细颗粒度的权限管控，无论是国密卡的加密通讯还是人脸识别的活体检测，都确保了通行的绝对安全。在效率层面，接口返回的`accessType`与`inOut`字段，让系统能够精准区分人员是通过门禁进入大楼，还是通过梯控到达特定楼层，亦或是车辆通过车牌识别驶入停车场。

这些数据不仅记录了轨迹，更通过分析优化了资源配置。例如，在智慧工厂中，MES系统可根据`accessPassport`（工号或卡号）自动触发产线权限；在智慧医院中，HIS系统可依据`evTime`（时间）与`areaName`（区域）实现医护人员的自动考勤与病患探视管理。多奥智能一卡通，以接口为桥梁，以数据为纽带，为您构建一个安全、高效、互联的智慧生态。