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