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

更新时间: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 }

错误码

参考 错误码