05、设备信息定时推送

5.1 功能概述

  服务器推送跟同步返回区别为数据不是通过客户服务器(客户端)发起,而是物联网云平台服务器向客户服务器(客户端)推送。

  商户客户端服务器要能够处理物联网云平台服务器推送过来的请求(数据)。

  推送的数据来自于设备自身,主要包括设备运行期间产生的上报数据和下发指令的执行结果。

5.2 推送地址

  商户客户端服务器给出地址端口,支持 http 和 https 协议

5.3 推送来源

  iot.znskiot.com 对应 IP 地址

  安全认证:

    A: IP来源认证。平台服务器IP地址固定,可对数据来源做认证。

    B: 请求头 Authorization 参数认证。 请求头添加 Authorization 加密认证字段,加密内容与第一章的描述的生成 activekey 类似,生成的 activekey 再采用base64编码后即为加密认证内容。

5.4 HTTP 请求方式

  POST

5.5 返回格式

  无需返回

5.6 推送参数

参数名称 参数类型 是否必须 描述
action String 参数取值为:"data_report"
payload String 携带参数:
msgseq|deviceid|type|gatewayid|battery|temperature|envtemperature|lng|lat|closingflag|damage|rssi|intervals|update
code Int 此处取值为 1

payload参数说明

msgseq :

  为消息序号

deviceid:

  为设备编号

type:

  设备型号,具体为:

type取值 含义 / 功能描述 备注
0 RF 耳标 -
1 Lora 耳标 -

gatewayid

  为网关编号。没有网关的直连设备取值为0

其它数据字段 含义如下:

字段名称 含义 / 功能描述 备注
battery 电池电量 小数,例如 3.20
temperature 设备温度(目标体温) 小数,例如 37.60
envtemperature 环境温度 小数,例如 22.30
lng 设备GPS经度坐标 小数,例如 114.066105
lat 设备GPS纬度坐标 小数,例如 22.549458
closingflag 合盖状态 0 合盖;
1 开盖
damage 拆盒盖次数 整数
rssi 标签信号 0 信号正常;
1 信号弱或信号异常;
负值 为实际信号强度(单位dBm);
intervals 数据上报时间间隔 单位分钟,例如 30
update 数据上报时间戳 Unix时间戳,例如 1616494664

> >

关于设备位置信息说明

  1、如果设备是没有网关的直连设备,设备位置为设备自身的位置信息;

  2、如果设备是通过网关连接的非直连设备,设备位置为网关的位置信息;

  3、如果设备GPS经度坐标和纬度坐标都为 0.0 ,则该设备不支持定位;

5.7 推送示例

RF 耳标温度推送:

curl -H "Authorization:MTVhMDhjNz1586826744" -d "action=data_report&code=0&payload=100246494665|1000062|0|1000001|3.00|38.00|24.00|114.066105|22.549458|0|22|0|30|1616494664" https://www.abcd.com:1234/api/znskiots

results matching ""

    No results matching ""