文档HTTP 数据接口历史数据接口
HTTP 数据接口

历史数据接口

更新于 2022-08-29

接口描述

本接口为设备历史数据接口。
接口调用有频率限制:单个IP每秒最多一次
通过调用此接口可以获得设备一段时间内,从开始时间往后计算,最多两天数据。

接口调用

  • GET /api/data/range?placeId=<placeId>&st=<st>&et=<et> HTTP/1.1
    Host: dev.thuwater.com
    X-TH-TOKEN: 26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766
    

调用参数

参数名称必填说明
X-TH-TOKEN是通过登陆接口获取的token
placeId是安装点ID
st是开始时间 格式 yyyy-MM-dd HH:mm:ss
et是结束时间 格式 yyyy-MM-dd HH:mm:ss

接口响应

  • HTTP/1.1 200 OK
    Content-Type: application/json
    
    [
      {
        "placeId" : "1111", // placeId 安装点ID
        "equipId" : "xxxx", // equipId 设备ID
        "equipType": "xxxx", // 安装设备类别
        "sampletime" : "2019-01-01 01:01:01",  // 监测时间
        "c3" : "4.123",  // 参考 设备数据说明接口
        "c4" : "4.123",  // 参考 设备数据说明接口
        "c5" : "4.123",  // 参考 设备数据说明接口
        ...
      },{
        .....
      },
      ......
    ]

响应参数

参数名称说明
httpcode200-正常,401-无权限,500-其他错误。
placeId安装点ID
equipId设备ID
equipType设备类型编码
sampletime监测时间
c3/c4/c5...参考 设备数据说明

接口调用有频率限制:单个IP每秒最多一次
返回数据有数量限制:从开始时间往后计算,最多两天数据。
当无数据的时候返回:[ ]