智读表API文档

获取设备数据以及图片路径

接收识别数据推荐使用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

这里的时间戳参数请严格按照时间戳格式提交,对时间戳不了解的可以参考 在线时间戳

返回数据

说明:根据设备配置的数据源不同,返回数据格式略由差异;admin配置为设备端结果,返回结果参考第一种格式,配置云端结果(默认),否则返回结果参考第二种格式

数据源获取:根据设备名查找设备接口获取datFrom,0代表云端结果(识别),1代表本地结果(本地识别)
第一种格式
{
    "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       //一表多值情况下数据体
            }
        ]
    }
}