用户卡片离线设置

本接口只对二代网关、二代蓝牙锁生效

接口说明

用户卡片有变化时,将网关关联的所有锁的卡片信息同步到接口。
平台接收数据后保存到数据库,并在确保网关在线后,将原卡片数据清空后,再逐一将卡片写入网关。

本接口会删除所有旧卡片数据,请勿频繁调用。建议每小时/每天检测数据有变更再推送数据。

功能说明

用户卡片有两种身份: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