网关心跳请求
网关启动后每隔五分钟会推送心跳信息。
一代网关:
心跳数据会分三次推送数据。第一条会返回锁Lock1、Lock2,第二条会返回锁Lock3、Lock4,第三条会返回锁Lock5、Lock6。
二代网关:
心跳数据一次性全部推送完成。
接口地址
POST {用户端回调地址}?cmd=Heartbeat
body参数示例
{
"token":"12345678901234567890123456789012",
"dataId":"3a86138b-d39a-4c0a-98ec-2b3b6f6d2d9d",
"ssid":"112134328572",
"tenantId":"TEST",
"gatewaySN":"210031000999",
"timestamp":"2024-11-12 13:43:28",
"temperature":"25",
"count":"2",
"rssi":"-56",
"lock1":"49000040",
"lock2":"49000039",
"lock3":"",
"lock4":"",
"lock5":"",
"lock6":"",
"lockInfos":[{
"sn":"49000040",
"battery":"100",
"rssi":"-56",
"mode":"01",
"lockStatus":"S01",
"doorStatus":"S04",
"alarmStatus":"E00",
"connected":true,
"time":"2024-12-20 15:14:13"
},{
"sn":"49000039",
"battery":"100",
"rssi":"-56",
"mode":"01",
"lockStatus":"S01",
"doorStatus":"S04",
"alarmStatus":"E00",
"connected":true,
"time":"2024-12-20 15:14:13"
}]
}说明:添加卡号“310d7b34” 作为 智能锁“49000040” 的管理卡,编号为1号。
参数说明
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| 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 |
| temperature | string(5) | 是 | 温度 |
| count | string(1) | 是 | 蓝牙锁数量 |
| rssi | string(5) | 是 | 蓝牙信号 |
| lock1 | string(8) | 是 | 蓝牙锁1编号 |
| lock2 | string(8) | 是 | 蓝牙锁2编号 |
| lock3 | string(8) | 是 | 蓝牙锁3编号 |
| lock4 | string(8) | 是 | 蓝牙锁4编号 |
| lock5 | string(8) | 是 | 蓝牙锁5编号 |
| lock6 | string(8) | 是 | 蓝牙锁6编号 |
| lockInfos | 对象数组 | 是 | 锁信息对象数组 |
| -sn | string(8) | 是 | 锁编号 |
| -connected | bool | 是 | 是否连接上蓝牙锁。True:网关曾经连接上蓝牙锁 ;False:网关开机/重启后就没有连接上蓝牙锁。当值为false时,其它剩余字段的值都不可用 |
| -time | string | 是 | 当connected=true时,表示网关最后一次与蓝牙锁通讯的时间 |
| -battery | string(3) | 是 | 锁电量 |
| -rssi | string(5) | 是 | 蓝牙信号 |
| -mode | string(2) | 是 | 锁单双卡模式,01-单卡,02-双卡。二代锁默认是 01 |
| -lockStatus | string(3) | 是 | 锁状态:S01-关锁,S02-开锁 |
| -doorStatus | string(3) | 是 | 门状态:S03-门打开,S04-门关闭 |
| -alarmStatus | string(3) | 否 | 告警状态:E00-无,E10-开锁失败,E11-关锁失败 |
返回参数
返回 HttpStatus 为 200 的任意回复即可。
作者:阮德明 创建时间:2025-06-05 16:22
最后编辑:阮德明 更新时间:2025-11-17 16:50
最后编辑:阮德明 更新时间:2025-11-17 16:50