智能梯控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、名称、编号信息
相关推荐
仿生狮子2 小时前
OpenAI 攻下千禧年难题之后，开发者似乎无动于衷
前端·数学·vibecoding
Lvan的前端笔记6 小时前
docker：每个前端项目一个 Nginx 容器还是只有一个Nginx容器
前端·nginx·docker
三天不学习6 小时前
Egg.js 4 突然爆火，原因是否归结于AI 原生落地需求爆发？
前端·javascript·全栈·egg.js
xcs194057 小时前
前端 vue 的前端页面debugger 进不去
前端·javascript·vue.js
天启HTTP7 小时前
爬虫防封核心原理：IP轮换机制与风控规避逻辑
linux·服务器·网络·爬虫·tcp/ip
运维行者_8 小时前
网络性能监控怎么做？从自动发现到根因分析的4个环节
运维·服务器·网络·人工智能·支持向量机
信奥卷王8 小时前
[GESP202609 六级] 分树规划
算法
夏幻灵8 小时前
LeetCode 21：合并两个有序链表——双指针与哑节点详解
算法·leetcode·链表
明月_清风8 小时前
Deno 终局来了：从挑战 Node 到被 Cloudflare 收编
前端·后端·node.js
热门推荐
01如何新建文件夹？ 电脑新建文件夹的4种方法02国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）03历年考研数学一、数学二、数学三真题试卷及答案PDF04GitHub 镜像站点05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接06轻量化AI渗透武器库｜ARTEX自主攻防系统、资产梳理、漏洞挖掘、链路分析全流程智能化落地07Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）08Telegram APK 下载安装完整指南 — 2026年最新09微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新10几个好用的ip纯净度检测网站