刷卡开锁请求

用户使用IC卡在蓝牙锁刷卡后,平台推送刷卡数据到用户端接口。用户接收到数据后,根据业务需求处理刷卡开锁请求。

用户是否授权开锁,可调用接口 刷卡开锁回复 进行回复。

如果用户不调用接口回复,蓝牙锁会在等待一段时间后提示授权超时。

接口地址

POST {用户端回调地址}?cmd=CardSwipe

body参数示例

 {
     "token":"12345678901234567890123456789012",
     "dataId":"3a86138b-d39a-4c0a-98ec-2b3b6f6d2d9d",
     "ssid":"112134328572",
     "tenantId":"TEST",
     "gatewaySN":"210031000999",
     "timestamp":"2024-11-12 13:43:28",
     "mode":"01",
     "sleep":"1",
     "card":"310d7b34,00000000",
     "lockSN":"49000040",
     "lockInfo":{
        "sn":"49000040",
        "battery":"100",
        "rssi":"-56",
        "mode":"01",
        "lockStatus":"S01",
        "doorStatus":"S04",
        "alarmStatus":"E00"

    },
 }

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

body参数说明

参数名称 类型 是否必填 说明
dataId string(32) 用户调用接口时提供的数据唯一ID
tenantId string(32) 租户ID
gatewaySN string(12) 网关序列号;
timestamp string 当前时间,格式”yyyy-MM-dd HH:mm:ss”
token string(36) 加密字符串
ssid string(12) 用户调用接口时提供的任务ID
mode string(2) 操作模式:01-单卡开锁,02-双卡开锁
sleep string(4) 休眠时间
card string(17) 每张卡片为8位编号。卡片不存在时显示为“00000000”
lockSN string(8) 8位智能锁编号
lockInfo object 锁信息对象
-sn string(8) 锁编号
-battery string(3) 锁电量
-rssi string(5) 蓝牙信号
-mode string(2) 锁单双卡模式,01-单卡,02-双卡
-lockStatus string(3) 锁状态:S01-关锁,S02-开锁
-doorStatus string(3) 门状态:S03-门打开,S04-门关闭
-alarmStatus string(3) 告警状态:E00-无,E10-开锁失败,E11-关锁失败

返回参数

返回 HttpStatusCode 为 200 的任意回复即可。

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