网关心跳请求

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

一代网关:

心跳数据会分三次推送数据。第一条会返回锁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