用户卡片离线设置
本接口只对二代网关、二代蓝牙锁生效
接口说明
用户卡片有变化时,将网关关联的所有锁的卡片信息同步到接口。
平台接收数据后保存到数据库,并在确保网关在线后,将原卡片数据清空后,再逐一将卡片写入网关。
本接口会删除所有旧卡片数据,请勿频繁调用。建议每小时/每天检测数据有变更再推送数据。
功能说明
用户卡片有两种身份:1:普通用户;2:管理员 。
每个卡片在每把蓝牙锁中只能有一个身份。
当网关离线时,用户在蓝牙锁上刷卡开锁,将不再使用网络接口就行权限的校验,而是直接查询网关内部数据库,是否存在对应的卡片,如果卡片校验通过则直接开锁。
开锁日志会在网关联网后通过日志推送接口发送到用户端。
校验逻辑如下:
- 蓝牙锁处于单卡模式:任意身份的用户都可开锁
- 蓝牙锁处于双卡模式:开锁用户中,必须至少有一个用户是管理员,才能开锁
接口地址
POST /api/BluetoothLock/v2/UserCardManageOffline
body参数示例
{
"token":"12345678901234567890123456789012",
"dataId":"a389a35f-a41f-4dd6-b570-4e896c5279c6",
"ssid":"112191019146",
"tenantId":"TEST",
"gatewaySN":"210031000999",
"timestamp":"2024-11-12 19:10:19",
"cards":[
{
"lockSN":"49000040",
"admin":["b2c99047","310d7b34"],
"user":["310d7b35"]
},
{
"lockSN":"49000039",
"admin":["b2c99047","310d7b34"],
"user":["310d7b36"]
}
]
}参数说明
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| 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 |
| cards | 数组 | 是 | 卡片数组 |
| > lockSN | string(8) | 是 | 锁编号 |
| > admin | 字符串数组 | 是 | 管理员的卡片数组 |
| > user | 字符串数组 | 是 | 普通用户的卡片数组 |
返回参数
详见文档 接入方式 [接口响应数据]相关段落
作者:阮德明 创建时间:2025-06-05 16:21
最后编辑:阮德明 更新时间:2025-11-17 16:50
最后编辑:阮德明 更新时间:2025-11-17 16:50