云服务 API 参考设备高级服务垂直品类硬件 API智能发卡器开放能力卡片操作获取写卡记录

获取写卡记录

更新时间：2023-06-20 14:54:06下载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
}

错误码

参考错误码。

上一篇读取卡片在云端保存的信息

下一篇网关开放能力