刷卡开锁请求
用户使用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
最后编辑:阮德明 更新时间:2025-11-17 16:50