用户卡片设置

说明

用户刷卡开锁时，如果网关处于离线状态，将会读取网关内存储的用户卡片与锁号信息，如果数据存在且校验通过，将会直接授权开锁。
开锁记录将会存储在网关中，当网关重新在线时，会把开锁记录通过 [日志回调] 接口推送给用户。
每张卡片在每把智能锁中只能有一条记录；不能添加同一张卡片到同一智能锁中，否则会开锁异常。

用户卡片类型：普通用户、管理用户（见调用参数字段 isAdmin）
校验方式：
- 单卡模式：所有用户都可开锁
- 双卡模式：开锁用户中，必须至少有一个用户是管理用户，才能开锁

接口地址

POST /api/BluetoothLock/v2/UserCardManage

body参数示例

 {
     "token":"12345678901234567890123456789012",
     "dataId":"3a86138b-d39a-4c0a-98ec-2b3b6f6d2d9d",
     "ssid":"112134328572",
     "tenantId":"TEST",
     "gatewaySN":"210031000999",
     "timestamp":"2024-11-12 13:43:28",
     "mode":"01",
     "number":"1",
     "isAdmin":true,
     "card":"310d7b34",
     "lockSN":"49000040"
 }

说明：添加卡号“310d7b34” 作为智能锁“49000040” 的管理卡，编号为1号。

参数说明

参数名称	类型	是否必填	说明
dataId	string(32)	是	32位长度的唯一数据ID，可使用GUID生成
tenantId	string(32)	是	租户ID
gatewaySN	string(12)	是	网关序列号；
timestamp	string	是	当前时间，格式”yyyy-MM-dd HH:mm:ss”
token	string(36)	是	加密字符串
ssid	string(12)	否	用户自行生成的12位唯一任务ID
mode	string(2)	是	操作模式：01-新增指定编号卡片，11-查询指定编号卡片，21-删除指定编号卡片，22-清空网关所有卡片
number	string(4)	是	卡片编号，范围：1-600
isAdmin	bool	是	是否管理人员
card	string(8)	是	8位卡片编号，当 mode 不为 01 时，可为空字符串
lockSN	string(8)	是	8位智能锁编号，当 mode 不为 01 时，可为空字符串

返回参数

详见文档接入方式 [返回参数]相关段落

作者：阮德明创建时间：2025-06-05 16:20
最后编辑：阮德明更新时间：2025-11-17 16:50

用户卡片管理

用户卡片设置

说明

接口地址

body参数示例

参数说明

返回参数