历史数据接口最近更新时间：2022-08-29 16:14:14

# 接口描述

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

# 接口调用

http

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

yaml

      /api/data/range:
    get:
      tags:
        - 设备历史数据
      summary: 设备历史数据接口。
      description: 设备历史数据接口。返回数据有数量限制：从开始时间往后计算，最多2880条数据
      parameters:
        - name: X-TH-TOKEN
          in: header
          description: 通过登陆接口获取的token
          required: true
          schema:
            type: string
        - name: placeId
          in: query
          description: 安装点ID
          required: true
          schema:
            type: integer
        - name: st
          in: query
          description: 开始时间 格式 yyyy-MM-dd HH:mm:ss
          required: true
          schema:
            type: string
            format: dateTime
        - name: et
          in: query
          description: 结束时间 格式 yyyy-MM-dd HH:mm:ss
          required: true
          schema:
            type: string
            format: dateTime

javascript

      var request = require("request");

var options = {
  method: 'GET',
  url: 'https://dev.thuwater.com/api/data/range',
  "qs": {
    placeId: 1111,
    st: '2019-08-10 00:00:00',
    et: '2019-08-10 03:00:00'
  },
  headers: {
    'Host': 'dev.thuwater.com',
    'X-TH-TOKEN': '26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766'
  }
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);
  console.log(body);
});

java

      OkHttpClient client = new OkHttpClient();
HttpUrl url = HttpUrl.parse("https://dev.thuwater.com/api/data/range")
                     .newBuilder()
                     .addQueryParameter("placeId", 1111)
                     .addQueryParameter("st", "2019-08-10 00:00:00")
                     .addQueryParameter("et", "2019-08-10 03:00:00")
                     .build();

Request request = new Request.Builder()
  .url(url)
  .get()
  .addHeader("X-TH-TOKEN", "26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766")
  .build();

Response response = client.newCall(request).execute();

# 调用参数

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

# 接口响应

http

      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",  // 参考 设备数据说明接口
    ...
  },{
    .....
  },
  ......
]

# 响应参数

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

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