云服务 API 参考设备高级服务垂直品类硬件 API智能发卡器开放能力卡片操作读取卡片在云端保存的信息

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

更新时间：2023-06-20 14:54:05下载pdf

本文介绍读取卡片在云端保存的信息的 API。

接口描述

读取指定卡片在云端保存的信息。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备编号
card_id	String	uri	true	卡号

返回参数

参数名	类型	说明
result	CardEntityVO	卡片信息对象

result 说明

参数名	类型	说明
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	时区
lang	String	语言类型，用于生成默认名称

请求示例

GET: /v1.0/devices/6cdb36b2e489885fa57lzm/door-lock/card-issuers/cards/1234567/sectors

返回示例

{
    "result": {
        "effective_time": 1623465360000,
        "type": 2,
        "dev_id": "6c8bcd1020b712c2c4ibrq",
        "schedule_flag": 1,
        "bind_id": "615",
        "working_day": 60,
        "name": "卡0615",
        "invalid_time": 1623900960000,
        "schedule_end": "20:00",
        "id": "4a5be5ef",
        "time_zone_id": "",
        "schedule_start": "08:00"
    },
    "t": 1623746033654,
    "success": true
}

错误码

参考错误码。

上一篇删卡

下一篇获取写卡记录