接收识别数据推荐使用MQTT协议实时订阅接收数据,而不是通过定时任务去定时查询设备的识别数据,mqtt接收数据的文档地址 http://47.99.190.254:8014/zh-cn/docs/introduction/introduction.html 。一个是设备上报的时间加上数据处理的耗时可能会比设置的时间有延迟,还有一个原因是如果定时任务请求过于频繁的话会被服务进行限制。
API前缀:详见简介
Path: /data/v1/dataAndPic
Method: GET
接口描述:
Query
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
productKey | 是 | 产品key(二级目录) | |
deviceName | 是 | 设备名称(uuid序列号) | |
startTimeStamp | 是 | 1540000000 | 开始时间戳,精确到秒,10位数字 |
endTimeStamp | 是 | 1606786354 | 结束时间戳,精确到秒, 10位数字 |
currentPage | 是 | 1 | 当前页 从1开始 |
pageSize | 是 | 10 | 每页记录数 |
access_token | 是 | 访问令牌,获取步骤详见 获取或者刷新token |
这里的时间戳参数请严格按照时间戳格式提交,对时间戳不了解的可以参考 在线时间戳 。
{
"code":200,
"msg":"OK",
"data":{
"total":1, //符合该条件的数据记录条数
"pageNum":1, //当前页码
"pageSize":1, //每页数据条数
"pages":1, //共有几页
"list":[
{
"requestId":"9d53e43f-1fbd-4312-b53d-54e8f4c44cb7", //该条数据的唯一ID
"dataTypeId":160,
"createTime":"2020-04-26 17:54:32", //数据上传时间
"angle":0,
"magnificationList": [],//倍率
"data":{
"electricity": 98.57, //读表器剩余电量百分比,非电表读数
"value":122, // 本地表计识别读数
"localIncrement": 0.0 , //本地增量
"lightValue":"00101011" //指示灯类型数据,8位二进制表示
},
"path": "https://www.smartmetering.top/xxxxxxxxxxx.jpg", //当前表计拍照图片,若未传图则为空
"dataBeanList":null //一表多值情况下数据体
}
]
}
}
{
"code":200,
"msg":"OK",
"data":{
"total":1, //符合该条件的数据记录条数
"pageNum":1, //当前页码
"pageSize":1, //每页数据条数
"pages":1, //共有几页
"list":[
{
"requestId":"9d53e43f-1fbd-4312-b53d-54e8f4c44cb7", //该条数据的唯一ID
"dataTypeId":160,
"createTime":"2020-04-26 17:54:32", //数据上传时间
"angle":0,
"magnificationList": [],//倍率
"data":{
"electricity": 98.57, //读表器剩余电量百分比,非电表读数
"number": 5415.0, // 云端表计识别读数
"cloudIncrement": 0.0 //云端增量
},
"path": "https://www.smartmetering.top/xxxxxxxxxxx.jpg", //当前表计拍照图片,若未传图则为空
"dataBeanList":null //一表多值情况下数据体
}
]
}
}