查询门禁通行日志

更新时间:2023-06-15 05:57:57

本文介绍查询门禁通行日志的 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 }

错误码

参考 错误码