查询门禁通行日志

更新时间：2023-06-21 07:12:54下载pdf

本文介绍查询门禁通行日志的 API。

接口描述

多条件分页查询门禁通行日志。

接口地址

GET: /v1.0/iot-02/access-control-logs

请求参数

参数名	类型	参数位置	是否必填	说明
request	HighWayAccessControlAccessLogQueryRequest	query	true	门禁日志分页查询条件

request 说明

参数名	类型	是否必填	说明
uids	String	false	用户 ID 集合，多个请求使用半角逗号（,）分隔。
device_ids	String	false	门禁设备集合，多个请求使用半角逗号（,）分隔。
start_time	Long	false	创建时间范围查询，开始时间
end_time	Long	false	创建时间范围查询，结束时间
page_size	Integer	false	分页页面大小。默认值为 20 条，最大值为 200 条
page_no	Integer	false	分页页码。默认值为 1
export_face_img	Boolean	false	是否展示人脸抓拍图。默认值为 true true：展示 false：不展示
access_types	String	false	门禁通行类型。多个请求使用半角逗号（,）分隔。枚举类型: card：卡 password：密码 qr_code：二维码 face：人脸 fingerprint：指纹 remote：远程 other：其他

返回参数

参数名	类型	说明
result	HighwayPageResult

result 说明

参数名	类型	说明
total	Long	数据总条数
list	List	分页数据
has_more	Boolean	是否包含下一页

list 说明

参数名	类型	说明
device_id	String	设备 ID
name	String	通行人员姓名
user_id	String	通行人员 ID
access_time	Long	通行时间
access_type	String	通行类型
image_capture	String	通行抓拍人脸图
access_log_id	String	日志 ID

请求示例

GET: /v1.0/entrance-guard/access-controls/logs?access_types=remote&page_no=1&page_size=1

返回示例

{
    "result": {
        "list": [
            {
                "access_log_id": "146305039484531****",
                "access_type": "远程",
                "device_id": "vdevo16370312926****",
                "device_name": "智能门禁-vdevo",
                "user_id": "bay1633662217508****",
                "image_capture": "",
                "name": "sun",
                "access_time": 1637653370946
            }
        ],
        "total": 6,
        "has_more": true
    },
    "t": 1637653511622,
    "success": true
}

错误码

参考错误码。