菜单
HTTP数据接口 > API Reference > 设备数据说明
设备数据说明 最近更新时间:2022-08-29 16:14:14

# 设备数据说明

点击下载数据字典
字典预览
设备数据说明 预览

# 接口描述

本接口为设备数据说明接口。
通过调用此接口可以获得数据接口中出现的字段名的物理意义与单位。
用户需要参考此接口来选取数据接口中返回的有用数据列,数据接口返回的数据列并不是全部对用户有意义
数据接口获取的数据有一些字段在此未作说明,那是普通用户可以直接丢弃的程序调试字段
每种设备类型中列字段的对应关系是不变的,开发者不需要为此做动态绑定
建议开发者获取一次数据后存储到自己系统数据库作为字典表使用

# 接口调用

  •       GET /api/data/placeDataInfo HTTP/1.1
    Host: dev.thuwater.com
    X-TH-TOKEN: 26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766
    
  •       /api/data/placeDataInfo:
        get:
          tags:
            - 设备数据说明
          description: 设备数据说明接口。
          summary: 设备数据说明接口。
          parameters:
            - name: X-TH-TOKEN
              in: header
              description: 通过登陆接口获取的token
              required: true
              schema:
                type: string
  •       var request = require("request");
    
    var options = {
      method: 'GET',
      url: 'https://dev.thuwater.com/api/data/placeDataInfo',
      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();
    
    Request request = new Request.Builder()
      .url("https://dev.thuwater.com/api/data/placeDataInfo")
      .get()
      .addHeader("X-TH-TOKEN", "26b0e5bfcbc.214ce96c1f7c9f0a33549b81087579b38b6a8.e9ba17523a25d766")
      .addHeader("Host", "dev.thuwater.com")
      .build();
    
    Response response = client.newCall(request).execute();

# 调用参数

参数名称必填说明
X-TH-TOKEN通过登陆接口获取的token

# 接口响应

  •       HTTP/1.1 200 OK
    Content-Type: application/json
    
    [
      {
        "equipType": "1",
        "equipLabel": "液位仪",
        "dataInfos": [
        {"dataColumn":"c10","dataLabel":"液位","dataUnit":"m"},
        {"dataColumn":"c11","dataLabel":"井内温度","dataUnit":"℃"},
        ......
        ]
      },
      ......
    ]

# 响应参数

参数名称说明
httpcode200-正常,401-无权限,500-其他错误。
equipType设备类型编码
equipLabel设备类型名称
dataColumn数据列标识
dataLabel数据列名称
dataUnit数据单位

当无数据的时候返回:[ ]