智能梯控SDK可直接用于第三方开发对接的接口文档说明书

深圳多奥智能一卡（码、脸）通系统2026-08-31 8:36

这份 "智能梯控第三方接口简要说明" ​ 虽然篇幅不长，但抓住了梯控系统对接的核心要素：电梯与楼层自定义、权限批量授权、事件查询 。我将其整理成一份可直接用于第三方开发对接的接口文档，并以您给出的 JSON 示例为基础，补充完整的接口定义。

智能梯控第三方接口简要说明

一、梯控系统功能

1.电梯门禁楼层自定义

电梯IC卡梯控系统支持自定义智能梯控名称及对每部电梯设置不同楼层数量。

2.CPU卡电梯梯控楼层端口关联

IC卡电梯门禁系统支持对每部电梯的楼层与硬件梯控控制器继电器的关联。

3.人脸识别二维码电梯门禁权限授权

电梯国密门禁系统支持自定义电梯权限（电梯楼层组合），实现批量人员对电梯权限组合的授权方式。

4.乘梯事件查询（需联网），国密电梯门禁系统支持电梯梯控事件记录的查询。

二、多奥梯控系统优势

1、梯控楼层自定义；

2、电梯门禁楼层端口关联；

3、IC卡电梯权限批量授权；

4、人脸识别二维码电梯门禁事件记录实时查询；

三、梯控接口举例

elevId Int ID

elevName String 电梯名称

elevCount Int 电梯数量

floorCount Int 楼层数量

areaId Int 所属区域ID

areaName String 所属区域名称

floors Array 楼层数组

floorId Int 楼层ID

floorName String 楼层名称

floorNo Int 楼层号

智能梯控第三方接口简要说明

一、梯控系统功能概述

  1. 电梯门禁楼层自定义
    支持自定义电梯名称，并对每部电梯设置不同的楼层数量（例如 A 栋 10 层、B 栋 20 层）。
  2. CPU卡电梯梯控楼层端口关联
    支持将每部电梯的楼层与硬件梯控控制器上的继电器端口进行关联映射，确保刷卡后正确的楼层按钮被点亮。
  3. 人脸识别/二维码电梯门禁权限授权
    支持自定义电梯权限（即楼层组合），并可对批量人员进行授权，实现"一键授权、多人生效"。
  4. 乘梯事件查询（需联网）
    支持实时查询电梯梯控事件记录（刷卡、人脸、二维码通行记录），便于审计与追溯。

二、梯控系统优势

  • 梯控楼层自定义：灵活适配不同建筑的楼层配置
  • 电梯门禁楼层端口关联：硬件与软件映射清晰，维护简便
  • IC卡电梯权限批量授权：节省人力，提高效率
  • 人脸识别/二维码电梯门禁事件记录实时查询：数据即时可见，支持安全审计

三、接口定义（RESTful API）

3.1 获取电梯列表（含楼层信息）

接口地址 ：GET /api/elevator/list

功能说明：获取系统中所有电梯及其楼层信息，用于前端展示或权限配置。

请求参数 ：无（或可选 areaId 按区域过滤）

返回示例（您提供的 JSON）：

复制代码
复制代码
复制代码 
{
    "status": 0,
    "msg": "success",
    "data": [
        {
            "elevId": 10,
            "elevName": "大堂电梯",
            "elevCount": 1,
            "floorCount": 2,
            "areaId": 160,
            "areaName": "test",
            "floors": [
                {
                    "floorId": 162,
                    "floorName": "楼层[1]",
                    "floorNo": 1
                },
                {
                    "floorId": 163,
                    "floorName": "楼层[2]",
                    "floorNo": 2
                }
            ]
        },
        {
            "elevId": 12,
            "elevName": "A栋",
            "elevCount": 1,
            "floorCount": 2,
            "areaId": 160,
            "areaName": "test",
            "floors": [
                {
                    "floorId": 187,
                    "floorName": "楼层[5]",
                    "floorNo": 5
                },
                {
                    "floorId": 188,
                    "floorName": "楼层[6]",
                    "floorNo": 6
                }
            ]
        }
    ]
}

字段说明：

字段 类型 说明
elevId Int 电梯ID
elevName String 电梯名称
elevCount Int 电梯数量（通常为1，表示一部电梯）
floorCount Int 楼层数量（受控楼层数）
areaId Int 所属区域ID
areaName String 所属区域名称
floors Array 楼层数组
floorId Int 楼层ID
floorName String 楼层名称（如"楼层1"）
floorNo Int 楼层号（实际物理楼层）
3.2 电梯权限授权接口

接口地址 ：POST /api/elevator/auth

功能说明：为用户或卡号授予特定电梯的楼层权限。

请求参数（JSON）：

复制代码
复制代码
复制代码 
{
    "userId": 12345,          // 用户ID（可选，与cardNo二选一）
    "cardNo": "A1B2C3D4",     // 卡片编号（可选）
    "elevId": 10,             // 电梯ID
    "floorIds": [162, 163],   // 授权楼层ID数组
    "startTime": "2026-09-01 00:00:00",  // 有效期起始
    "endTime": "2027-09-01 23:59:59"     // 有效期截止
}

返回示例：

复制代码
复制代码
复制代码 
{
    "status": 0,
    "msg": "success",
    "data": {
        "authId": 8888
    }
}
3.3 批量授权接口

接口地址 ：POST /api/elevator/batch-auth

功能说明：对多个用户/卡批量授予相同的电梯权限。

请求参数：

复制代码
复制代码
复制代码 
{
    "userIds": [123, 456, 789],
    "elevId": 10,
    "floorIds": [162, 163],
    "startTime": "...",
    "endTime": "..."
}

返回：同上。

3.4 取消授权接口

接口地址 ：DELETE /api/elevator/auth/{authId}

功能说明：取消指定授权记录。

返回：

复制代码
复制代码
复制代码 
{
    "status": 0,
    "msg": "success"
}
3.5 查询乘梯事件记录

接口地址 ：GET /api/elevator/event

功能说明：查询电梯通行事件（刷卡、人脸、二维码等）。

请求参数：

参数 类型 必填 说明
elevId Int 否 电梯ID，不传则查询全部
startTime String 否 起始时间（yyyy-MM-dd HH:mm:ss）
endTime String 否 结束时间
page Int 否 页码，默认1
pageSize Int 否 每页条数，默认20

返回示例：

复制代码
复制代码
复制代码 
{
    "status": 0,
    "msg": "success",
    "data": {
        "total": 150,
        "list": [
            {
                "eventId": 10001,
                "elevId": 10,
                "elevName": "大堂电梯",
                "floorNo": 5,
                "cardNo": "A1B2C3D4",
                "userName": "张三",
                "verifyMode": "IC卡",       // 验证方式：IC卡/人脸/二维码
                "eventTime": "2026-08-30 09:15:32",
                "result": 0                 // 0=成功，1=失败
            }
        ]
    }
}
3.6 获取电梯楼层端口关联信息

接口地址 ：GET /api/elevator/{elevId}/port-map

功能说明：获取某部电梯的楼层与硬件继电器端口的映射关系，用于硬件调试。

返回示例：

复制代码
复制代码
复制代码 
{
    "status": 0,
    "msg": "success",
    "data": [
        {
            "floorId": 162,
            "floorNo": 1,
            "portNumber": 1       // 继电器端口号
        },
        {
            "floorId": 163,
            "floorNo": 2,
            "portNumber": 2
        }
    ]
}

四、接口通用规范

  • 基础URL ：http://{server_ip}:{port}/api/v1
  • 认证方式 ：Header 携带 Authorization: Bearer {token}
  • 请求格式 ：application/json
  • 响应格式 ：统一为 {"status":0, "msg":"success", "data":{}}
  • 错误码 ：
    • 0：成功
    • 1001：参数错误
    • 1002：认证失败
    • 2001：电梯不存在
    • 2002：楼层不存在
    • 2003：授权冲突

五、对接流程建议

  1. 获取 Token：调用登录接口获取访问令牌
  2. 获取电梯列表：同步电梯与楼层基础数据到第三方系统
  3. 权限同步：将第三方系统（如 HR/OA）中的人员与电梯权限通过授权接口下发
  4. 事件订阅：可通过 Webhook 或定时轮询接口获取通行记录，用于考勤或安全审计

总结：本接口文档基于多奥梯控系统的核心能力（楼层自定义、端口关联、批量授权、事件查询）定义了四个主要接口，覆盖了第三方对接中最常用的场景。实际开发中可依据此文档快速完成与梯控系统的集成。

📋 核心信息梳理

🔧 核心功能
  • 支持电梯门禁楼层自定义，可设置梯控名称与单梯楼层数量
  • 能实现CPU卡梯控楼层端口与控制器继电器的关联
  • 支持人脸识别、二维码等多种方式的电梯权限批量授权
  • 联网状态下可实时查询乘梯事件记录
✨ 多奥梯控系统优势

将功能提炼为更聚焦的实用优势：

  1. 配置灵活：梯控楼层、端口关联均可自定义设置
  2. 管理高效：支持批量人员的电梯权限快速授权
  3. 数据透明：乘梯事件记录可实时查询追溯
📊 接口数据结构解析

以返回示例为基础，拆解核心字段含义：

字段名 类型 说明
elevId Int 电梯唯一标识ID
elevName String 电梯名称
floorCount Int 该电梯关联的楼层数量
areaId/areaName Int/String 所属区域ID及名称
floors Array 关联楼层数组，包含每个楼层的ID、名称、编号信息
相关推荐
维核科技15 分钟前
三个业务共用一台服务器，显存不够用了
大数据·服务器·人工智能
民乐团扒谱机22 分钟前
【读论文】基于波分复用和时分复用的单纤高精度双向时间传递系统
运维·服务器·网络
烂蜻蜓24 分钟前
Flask入门教程（十五）：错误处理与日志——打造健壮的Web应用
前端·python·flask
夜雪一千25 分钟前
服务器快慢怎么测？从命令行到脚本的完整指南
运维·服务器
不会就选b28 分钟前
Linux之socket编程(三)
linux·运维·服务器
深念Y31 分钟前
浏览器缩放检测的前端通用方案
前端
风骏时光牛马39 分钟前
AIAgent异常故障根因分析与复盘总结
前端
weixin_4316004440 分钟前
前端数据埋点（7）：Web Vitals——页面慢不慢，不是再包一层 fetch
前端·性能优化·sentry·数据埋点
DOLA_Tech1 小时前
WIN电脑中VMware虚拟机网速慢的解决办法
运维·服务器
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02GitHub 镜像站点03ZCode 周末送额度活动开启：3 亿 Token 免费领取042026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？05历年考研数学一、数学二、数学三真题试卷及答案PDF06微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新07Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费08蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接09AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路10VSCode+CodeX扩展，无法启动