简体中文
简体中文
English
联系我们
注册
登录

获取写卡记录

更新时间:2021-07-16 07:46:22下载pdf

本文介绍获取写卡记录的 API。

接口描述

获取写卡的记录。

接口地址

GET: /v1.0/devices/{device_id}/door-lock/card-issuers/cards

请求参数

参数名 类型 参数位置 是否必填 说明
device_id String uri true 设备编号
target_status Integer query true 查询记录状态
page_no Integer query true 页号,从1开始
page_size Integer query true 分页大小

返回参数

参数名 类型 说明
result OpenApiPagination

result 说明

参数名 类型 说明
has_more Boolean 是否还有更多页
total_pages Integer 总页数
unread_count Integer 未读数(本接口暂不使用)
total Integer 记录总条数
records List 写卡记录列表

records 说明

参数名 类型 说明
dev_id String 发卡器设备 ID
id String 卡编号
type Integer 卡片类型,1:周期性离线密码;2:房客;3:电梯;4:清空所有离线密码;5:身份证
name String 名称
bind_id String 绑定设备的 ID,支持门锁、房间号和电梯
bind_dev_name String 绑定的设备名称(只有类型是离线密码+清空码的时候, 该字段会有值, 对应的是离线密码对应的设备名称)
bind_value String 绑定的值(只有类型是离线密码+清空码的时候, 该字段会有值,值是对应的密码 ID)
effective_time Long 生效时间的13位的时间戳
invalid_time Long 失效时间的13位的时间戳
schedule_flag Integer 是否开启重复,0:否; 1:是
working_day Integer 所选周循环。scheduleFlag=1时才会处理该字段。workingDay 的格式说明: 一周的时间打标,bit0 ~ bit6 分别代表周日~周六; 1表示有效, 0表示无效; 最后一位以0表示。例如,周一/周二/周五的表示为: 01100100 = 100, 最终 workingDay=100
schedule_start String scheduleFlag=1时才会处理该字段,重复的开始时间, 比如 “08:30”
schedule_end String scheduleFlag=1时才会处理该字段,重复的结束时间, 比如 “18:30”
time_zone_id String 时区(atop 接口可以通过上下文获取到, 如果是 dubbo 接口需要传该字段)
lang String 语言类型,用于生成默认名称(atop接口可以通过上下文获取到, 如果是dubbo接口需要传该字段)

请求示例

GET: /v1.0/devices/6cdb36b2e489885fa57lzm/door-lock/card-issuers/cards?target_status=1&page_no=0&page_size=10

返回示例

{ "result": { "records": [ { "effective_time": 1623466800000, "bind_dev_name": "", "bind_value": "2337001", "type": 1, "dev_id": "6c8bcd1020b712c2c4ibrq", "schedule_flag": 0, "bind_id": "6c31e331ebee5563bejcl0", "name": "极限密码11", "invalid_time": 1624680000000, "id": "4a5be5ef", "time_zone_id": "" } ], "total_pages": 1, "total": 1, "has_more": false }, "t": 1623747274094, "success": true }

错误码

参考 错误码