5. 设备上下线通知[回调]

描述：

设备上下线会主动回调接口。
注意：通知成功，请按约定格式返回，否则连续重试3次。

请求说明：

协议 方法 PATH
HTTPS POST 服务商后台配置回调地址

Body参数：

参数 类型 必填 说明
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：onlineNotify
data String 是 设备信息字符串
- status int 是 设备状态，0：离线，1：上线
- time String 是 上下线时间
- region String 是 上下线地址
- ip String 是 上下线ip

返回参数：

参数 类型 必填 说明
code int 是 响应状态码
msg String 是 响应消息
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：onlineNotify
data String 是 空字符串，固定值：””

请求示例：

{"appId":"ym3b7f242fc0814489","expires":"1739583239","deviceNo":"123456789-987654321","sign":"36f392b389e945b5c7ca8baa36fae53b","cmd":"onlineNotify","data":"{\"status\":1,\"time\":\"2025-12-23 15:31:53.128\",\"region\":\"广东 深圳\",\"ip\":\"223.104.83.137:25118\"}"}

返回示例：

{
  "code": 0,
  "msg": "操作成功",
  "appId": "ymfaf99a8af3ec4b2e",
  "expires": "1767773309",
  "sign": "d158ba738f647502bf3e25661c99a540",
  "deviceNo": "123456789-987654321",
  "cmd": "onlineNotify",
  "data": ""
}
作者：yrh  创建时间：2026-06-06 09:48
最后编辑：yrh  更新时间：2026-06-06 09:50