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

这份 "智能梯控第三方接口简要说明" ​ 虽然篇幅不长,但抓住了梯控系统对接的核心要素:电梯与楼层自定义、权限批量授权、事件查询 。我将其整理成一份可直接用于第三方开发对接的接口文档,并以您给出的 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、名称、编号信息
相关推荐
小龙66664 分钟前
给 Agent 一张地图,而不是一座迷宫:前端 monorepo 目录结构重构实录
前端·agent
樊小肆6 分钟前
agent 不报错才最吓人:自研编码工具半年,我踩了 10 个"看着正常"的运行时坑
前端·人工智能·agent
鲸鹏芯海微电子科技上海有限公司11 分钟前
手机直连卫星,射频前端到底要解决什么?
前端·后端
FungLeo12 分钟前
FengCMS · PHP+MySQL 升级实录 · Web 入口收敛:Apache/Nginx 白名单挡住配置、安装 SQL、上传脚本直连
前端·mysql·php·安全加固·fengcms
费曼学习法27 分钟前
12 个工具调用改成并发,耗时从 94 秒掉到 23 秒:DeepSeek 并行调用工程细节
前端
修炼的dance32 分钟前
qpdf四个结构开关逐个开,只有对象流明显省
前端
测试员周周35 分钟前
【agent评测】:真实系统演示工具调用长什么样,用例怎么设计,怎么测
前端·后端·github
张明君644511 小时前
在 Astro SSR 项目中实现服务启动前初始化
前端·后端
上海潭龙东海科技有限公司1 小时前
智慧堆场动态模型三维实时孪生重构智能管控
大数据·网络·数据库·算法·重构
再吃一根胡萝卜2 小时前
从零实现 DSH 用户信息插件
前端