04、设置数据上传间隔
4.1 功能概述
为了节省电力,设备不会一直向平台传输数据,而是每隔一定时间才会向平台上报一次数据。
设备主动上传数据的间隔可以通过本接口进行设置。
注意:数据上传间隔时间越长越省电,默认的数据上传间隔是 60 分钟
4.2 请求地址:
http://iot.znskiot.com:6208/tags
4.3 信息依赖
同步返回参考信息,依赖异步服务器推送给出确切信息。
4.4 HTTP 请求方式
POST
4.5 返回格式
JSON
4.6 请求参数
参数名称 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
action | String | 是 | 参数取值为:"setgap" |
payload | String | 是 | 携带参数:masterid|activekey|deviceid|type|interval |
payload参数说明
masterid、activekey、deviceid 与前面的接口中payload参数对应字段功能和取值一致。
type:
目前只支持Lora耳标 type 取值必须为 1
interval:
interval 为上传时间间隔,单位为分钟。最小取值为 30,最大取值为 10080
4.7 请求示例
设置数据上传间隔为2小时:
curl -d "action=setgap&payload=1001|OGMzYmNiMz1586904179|1000062|1|120" http://iot.znskiot.com:6208/tags
4.8 服务响应
请求成功时服务器同步返回下面的JSON格式结果。
{
"action":"report",
"payload":"msgseq|deviceid|type",
"error":"error_code"
}
action 参数说明
action 与请求时的topic参数一致,为 "setgap"
payload 参数说明
msgseq 为消息序号,请记录这个消息序号。
deviceid、type 与请求中payload参数相关字段一致
error 参数说明
error 参数的 error_code 为错误的响应码,参照【附录一:错误的响应码】相关说明