心跳与在线离线v1.0.0

版本历史（最新：v1.0.0 / 2025-12-18）
版本 更新日期 更新说明 修改人
v1.0.0 2025-12-18 1. 新增设备在线离线通知 严永龙

一、说明

因设备的底层固件代码不同，所以判断设备在线离线的方式也不同。部分设备支持心跳，部分设备只支持在线离线事件。

二、事件名称及 ID 标识

事件名称 唯一标识 备注
设备在线 online 设备在线
设备离线 offline 心跳周期计算后的结果,不一定准确。

三、设备状态改变

3.1、接收设备上报事件消息

3.1.1、提供公网可访问的回调地址

示例：http://127.0.0.1:8080/device/heartbeat

3.1.2、http 方法及模块事件发送的请求示例
POSThttps://example.com/DEMO_RESOURCE
请求示例
CURL
curl -XPOST -H "Content-Type: application/json; charset=utf-8" "https://example.com/DEMO_RESOURCE" -d '{
    "did": "DEMO_DEVICE_001",
    "e": "online",
    "t": 18902981762,
    "sign": ""
}'
3.1.3、回调示例字段说明
字段 说明 备注
did 设备的唯一ID device_id、IMEI均能表示设备唯
一编号,传值时至少传一个
e 事件的alias 参考“事件名称及ID标识”表
● online 设备在线
● offline 设备离线
t 报警时间 服务器接收到设备报警时的时间
戳。因设备的时间不一定准确,
所以不是设备本身的时间。以最
新的时间为准。
sign 校验字段 通过算法得到一个字符串,并与
此字段比较。相同则代表本次数
据可靠。
生成规则。
data 传 "e=${事件的alias}&deviceId=${deviceId}" e:取报警时间
deviceId:设备的唯一ID
sign 生成说明：

请参考：《生成sign的示例代码》生成的在线离线业务特有 data 参数。