菜单
数据上传接口
数据上传接口 > API Reference > 数据上传接口
数据上传接口 最近更新时间:2022-08-29 16:14:14

# 接口描述

本接口为数据上传接口。
通过调用此接口可以上传数据信息。

# 接口调用

  •       POST /api/dataExternals/upload?equipType=1&equipId=1234 HTTP/1.1
    Host: dev.thuwater.com
    X-TH-TOKEN: 26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766
    
    [{"timestamp":"2019-01-01 00:00:00","xxx":"7.2","yyy":"2.2","zzz":2.2.....},
    {"timestamp":"2019-01-01 00:01:00","xxx":"7.3","yyy":"2.2".....},
    {"timestamp":"2019-01-01 00:05:00","xxx":"7.4","yyy":"2.1","zzz":"22.0".....}]
  •       var request = require("request");
    
    var options = {
      method: 'POST',
      url: 'https://dev.thuwater.com/api/dataExternals/upload?equipType=1&equipId=1234,
      "data": {
      },
      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);
    });
  •       OkHttpClient client = new OkHttpClient();
    HttpUrl url = HttpUrl.parse("https://dev.thuwater.com/api/data/range")
                             .newBuilder()
                             .addQueryParameter("equipType","1")
                             .addQueryParameter("equipId","1234")
                             .build();
    String josn ="[\n" +
                    "  {\"timestamp\":\"2019-01-01 00:00:00\",\"xxx\":\"7.2\",\"yyy\":\"2.2\",\"zzz\":2.2.....},\n" +
                    "  {\"timestamp\":\"2019-01-01 00:01:00\",\"xxx\":\"7.3\",\"yyy\":\"2.2\".....},\n" +
                    "  {\"timestamp\":\"2019-01-01 00:05:00\",\"xxx\":\"7.4\",\"yyy\":\"2.1\",\"zzz\":\"22.0\".....}\n" +
                    "]\n";
    RequestBody requestBody = RequestBody.create(josn, JSON);
    Request request = new Request.Builder()
      .url
      .post(requestBody)
      .addHeader("X-TH-TOKEN", "26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766")
      .build();
    
    Response response = client.newCall(request).execute();

# 调用参数

参数名称必填说明
X-TH-TOKEN对接时提供
equipType设备类型,自定义字符串
equipId设备ID,自定义字符串
bodyjson列表,总大小不应该超过500kb

# Body参数说明

参数名称说明
timestamp必填 时间戳 格式 yyyy-MM-dd HH:mm:ss
xxx上传的数据字段与值 请根据实际情况填写,然后请提供一份 设备ID/设备名称/设备类型/测量字段标识/物理单位 的对应关系表
yyy上传的数据字段与值 请根据实际情况填写,然后请提供一份 设备ID/设备名称/设备类型/测量字段标识/物理单位 的对应关系表

# 接口响应

  •       HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "result": true, 
        "msg": ""
    }

# 响应参数

参数名称说明
httpcode200-正常,401-无权限,406 不接受的参数或方法,500-其他错误。

# 返回说明

网络状况不好可能导致无响应/超时等
如果网络正常,返回 HTTP Status Code

  • 200 正常
  • 401 权限不够,具体就是X-TH-TOKEN的值过期或者失效
  • 406 不接受的参数或方法,请检查是否发送了配置错误的请求
  • 500 服务器错误,请过一段时间再重试