网关心跳请求

网关启动后每隔五分钟会推送心跳信息。

一代网关:

心跳数据会分三次推送数据。第一条会返回锁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
最后编辑:阮德明  更新时间:2026-09-08 11:06