查询门禁设备列表

接口说明

分页查询门禁设备信息以及通道信息

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6 及以上版本

接口版本

1.2.0

接口URL

/evo-apigw/evo-brm/1.2.0/device/subsystem/page

请求Method

POST

数据提交格式

application/json

请求参数

参数名必选类型长度说明
categorysarray-设备大类,门禁设备:8
typesarray-设备小类,详见:门禁设备小类,请求格式为:设备大类_设备小类,例如人脸门禁,8_16

其他参数以及示例详见:设备分页查询

门禁设备详情查询

接口说明

查询门禁设备详细信息

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6 及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/device/{deviceCode}

请求Method

GET

数据提交格式

application/json

请求参数

参数名必选类型长度说明
deviceCodestring50门禁设备编码

示例详见:设备详情查询

门禁设备树查询

接口说明

查询门禁设备树

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6 及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-brm/1.0.0/tree

请求Method

POST

数据提交格式

application/json

请求参数

参数说明以及示例详见:设备树查询

门状态同步

接口说明

发送获取门通道最新的开关门状态以及工作模式通知,等待结果异步返回后,可通过门状态查询接口查询
为保证查询结果的准确性,建议每天定时调用一次门状态同步接口,对平台门禁设备进行一次状态校准

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6 及以上版本

门禁管理子系统 V1.0.0 及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/evo-accesscontrol/1.0.0/card/accessControl/channelControl/getDoorStatus

请求Method

POST

数据提交格式

application/json

参数:

参数名必选类型长度说明
channelCodeListarray1000门禁通道编码,可调用设备管理接口,获取unitType为7的通道编码

请求参数示例

{
  "channelCodeList": ["1000003$7$0$0"]
}

返回参数说明

参数名类型说明
codestring错误码:0代表成功,非0具体错误码
errMsgstring错误信息
successboolean请求是否成功

返回示例

{
    "code": "0",
    "errMsg": "success",
    "success": true
}
门状态查询

接口说明

查询所有门禁通道开关门状态以及工作模式 接口qps=50

前置条件

请求头设置Authorization字段

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6 及以上版本

门禁管理子系统 V1.0.0 及以上版本

接口版本

1.0.0

接口url

/evo-apigw/evo-accesscontrol/1.0.0/card/accessControl/channelControl/channels

请求Method

POST

数据提交格式

application/json

参数名必选类型长度说明
channelCodestring64门通道编码(可通过设备管理接口,获取unitType为7的channels)
channelCodesarray1000门通道编码(可通过设备管理接口,获取unitType为7的channels)
doorGroupIdlong-门组ID

注意:通道编码和门组入参至少有一个,都存在的情况下,优先级:channelCode > channelCodes > doorGroupId

请求参数示例

  • 按通道单个查询:
{"channelCode":"1002725$7$0$1","allowSmartLock":false}
  • 按通道批量查询:
{"channelCodes":["1002725$7$0$1", "1002726$7$0$1"],"allowSmartLock":false}
  • 按门组查询:
{"doorGroupId":4,"allowSmartLock":false}

返回参数

参数名类型说明
codeString错误码
dataObject返回通道信息
errMsgString错误信息
successboolean请求是否成功

返回参数(data)具体内容说明

参数名类型说明
channelCodeString门禁通道编码
channelNameString门禁通道名字
channelSeqint通道序号
deviceCodeString设备编码
deviceModelString设备型号
deviceNameString设备名字
deviceTypeString设备类型
escFlagboolean梯控标记,详见 梯控标记字典
flagboolean冗余字段,默认false
idint自增ID
onlineStatusString设备状态,详见 门禁设备在离线状态字典
orgCodeString组织编码
orgNameString组织名称
statusint通道状态 1:开门,2:关门
validflagint是否可用
workModeint工作模式 0-普通,1-常闭,2-常开

返回示例

{
    "code":"0",
    "data":[
        {
            "channelCode":"1002725$7$0$1",
            "channelName":"172.3.111.57_门禁通道_2",
            "channelSeq":1,
            "deviceCode":"1002725",
            "deviceModel": "16",
            "deviceName":"172.3.111.57",
            "deviceType":"1",
            "escFlag":false,
            "flag":false,
            "id":252,
            "onlineStatus":"ON",
            "orgCode":"001005",
            "orgName":"yrx",
            "status":2,
            "validFlag":1,
            "workMode":0
        }
    ],
    "errMsg":"success",
    "success":true
}