HTTP 数据接口
设备数据说明
设备数据说明
以下为完整的设备数据字典,按设备类型列出数据接口各数据列(c1–c30)的物理意义与单位。
类型 1 · 液位仪(压力)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c10 | 液位 | m |
| c13 | 井内温度 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 2 · 流量仪(多普勒)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 3 · 雨量计
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c9 | 雨量 | mm/min |
| c13 | 井内温度 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 4 · 水质仪(SS)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c4 | 悬浮物 | — |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 5 · 原位仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c4 | 悬浮物 | — |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c18 | 电导率 | μS/cm |
| c19 | 盐度值 | ‰ |
| c20 | 设备电量百分比 | % |
类型 6 · 水质仪(DO)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c2 | 电压 | v |
| c4 | 溶解氧 | % |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 8 · 液位仪(超声波)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c10 | 液位 | m |
| c13 | 气温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 9 · 雨量计(天气网)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c12 | 雨量 | mm/min |
| c20 | 设备电量百分比 | % |
类型 10 · 流量仪(雷达)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c13 | 气温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 11 · 温湿度仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c12 | 雨量 | mm/min |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c20 | 设备电量百分比 | % |
类型 12 · 采样器
| 数据列 | 含义 | 单位 |
|---|---|---|
| c4 | 数据是否有效 | — |
| c5 | 电导率 | μS/cm |
| c6 | 悬浮物 | — |
| c7 | 溶解氧 | % |
| c8 | 温度 | ℃ |
| c13 | 主机温度 | ℃ |
| c20 | 设备电量百分比 | % |
类型 13 · 电导率流量仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c18 | 电导率 | μS/cm |
| c20 | 设备电量百分比 | % |
类型 14 · 溶解氧流量仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c4 | 溶解氧 | % |
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c20 | 设备电量百分比 | % |
类型 15 · 悬浮物流量仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c4 | 悬浮物 | — |
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c20 | 设备电量百分比 | % |
类型 16 · 液位仪(雷达)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c10 | 液位 | m |
| c13 | 井内温度 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 17 · THC液位仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c10 | 液位 | m |
| c13 | 井内温度 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 20 · 多指标水质监测仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 主机电压 | v |
| c10 | 液位 | m |
| c13 | 主机温度 | ℃ |
| c18 | 电导率 | μS/cm |
| c20 | 设备电量百分比 | % |
| c22 | 氨氮 | mg/L |
| c23 | pH值 | — |
类型 21 · 气象监测仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c9 | 雨量 | mm/min |
| c16 | 空气温度 | ℃ |
| c17 | 空气湿度 | % |
| c20 | 设备电量百分比 | % |
| c25 | 大气压 | hPa |
| c26 | 风速 | m/s |
| c27 | 风向 | ° |
| c28 | 光照 | Lux |
类型 22 · COD流量仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 主机电压 | v |
| c4 | COD | mg/L |
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c20 | 设备电量百分比 | % |
类型 23 · 多指标分流器
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 主机电压 | v |
| c4 | 溶解氧 | % |
| c6 | 浊度 | — |
| c18 | 电导率 | μS/cm |
| c19 | 电导温度 | ℃ |
| c20 | 设备电量百分比 | % |
| c21 | COD | mg/L |
| c22 | 氨氮 | mg/L |
| c23 | PH | — |
| c25 | 分流测量值 | — |
| c26 | 留样量 | — |
| c27 | 称重传感器 | — |
| c28 | 备用 | — |
类型 24 · 水质仪(电导率+氨氮+COD)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 主机电压 | v |
| c4 | COD | mg/L |
| c10 | 液位 | m |
| c13 | 主机温度 | ℃ |
| c18 | 电导率 | μS/cm |
| c20 | 设备电量百分比 | % |
| c22 | 氨氮 | mg/L |
| c23 | pH值 | — |
类型 30 · TWQ流量仪2.0协议
| 数据列 | 含义 | 单位 |
|---|---|---|
| c2 | 电压 | v |
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c20 | 设备电量百分比 | % |
类型 31 · 便携式流量仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c2 | 电压 | v |
| c7 | 流量 | L/s |
| c8 | 流速 | m/s |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c20 | 设备电量百分比 | % |
类型 32 · 水质仪(COD)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 主机电压 | v |
| c4 | COD | mg/L |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 33 · 水质仪(氨氮)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 主机电压 | v |
| c4 | 氨氮 | mg/L |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c16 | 环境温度 | ℃ |
| c17 | 环境湿度 | % |
| c20 | 设备电量百分比 | % |
类型 34 · 含水率监测仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c10 | 液位 | m |
| c13 | 水温 | ℃ |
| c18 | 含水率(%)1 | — |
| c19 | 含水率(%)2 | — |
| c20 | 设备电量百分比 | % |
| c21 | 含水率(%)3 | — |
类型 35 · 分布式微型液位仪
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c10 | 液位 | m |
| c13 | 气温 | ℃ |
| c14 | 中继温度 | ℃ |
| c15 | 中继湿度 | % |
| c20 | 设备电量百分比 | % |
类型 36 · 水质仪(ORP+PH)
| 数据列 | 含义 | 单位 |
|---|---|---|
| c1 | 中继电压 | v |
| c2 | 电压 | v |
| c10 | 液位 | m |
| c13 | 气温 | ℃ |
| c19 | ORP | mV |
| c20 | 设备电量百分比 | % |
| c23 | pH值 | — |
常用字段单位对照
| 字段 | 单位 | 备注 |
|---|---|---|
| 流量 | L/s | 单位时间内通过监测断面的水体体积,是排水管网流量监测的核心指标。 |
| 流速 | m/s | 水流通过监测断面的平均速度,与液位结合可推算过流断面面积与流量。 |
| 液位 | m | 水面相对于设备安装基准点的高度,用于判断积水深度与满管、溢流风险。 |
| 温度、井内温度、水温 | ℃ | 水体温度,影响水中生物活性、化学反应速率与溶解氧含量。 |
| 设备电量百分比 | % | 设备电池剩余电量百分比,用于运维判断是否需要更换电池。 |
| 电导率 | μS/cm | 水体传导电流的能力,反映溶解性离子总量,可间接判断水体污染或盐分变化。 |
| COD | mg/L | 化学需氧量(Chemical Oxygen Demand),氧化水中有机物所需的氧量,是衡量水体有机污染程度的核心指标。 |
| 氨氮 | mg/L | 水中以游离氨(NH₃)和铵离子(NH₄⁺)形式存在的氮,超标会消耗溶解氧并毒害水生生物,是污水排放的重要控制指标。特殊设备单位不一致得看字典字段后括号,部分设备以 mmol 计。 |
| 电压、中继电压、主机电压 | v | 设备供电回路电压,用于判断供电是否正常。 |
| 湿度、中继湿度、环境湿度、空气湿度 | % | 相对湿度;中继、环境湿度持续偏高可能意味着设备进水或结露风险。 |
| 含水率、含水率1、含水率2、含水率3 | % | 土壤或填充介质中水分所占百分比;含水率 1/2/3 为含水率监测仪第 1/2/3 路传感器读数。 |
| 溶解氧 | % | 水中溶解的分子氧含量,是水生生物生存和水体自净能力的关键指标。 |
| 盐度值 | ‰ | 水中溶解盐类的总量(千分比),可用于识别海水或工业盐水的混入。 |
| 雨量 | mm/min | 单位时间内的降雨深度,用于降雨事件识别与入流入渗分析。 |
| 大气压 | hPa | 监测点大气压力,可用于液位等测量数据的大气压力补偿。 |
| 风速 | m/s | 风的速度,气象参考数据。 |
| 风向 | ° | 风的来向角度(0°/360° 为正北),气象参考数据。 |
| 光照 | Lux | 光照强度,气象参考数据。 |
| 氧化还原电位(ORP) | mV | ORP = Oxidation-Reduction Potential,氧化还原电位。它衡量水体整体的氧化或还原能力,单位是 mV(毫伏)。 |
| 中继温度、主机温度、电导温度 | ℃ | 设备各部件温度,用于判断运行环境是否异常;电导温度用于电导率的温度补偿。 |
| 悬浮物 | — | 水中悬浮固体(SS)含量,升高意味着水体浑浊、污染加重。 |
| 气温、环境温度、空气温度 | ℃ | 环境空气温度,气象参考数据。 |
| 数据是否有效 | — | 设备自检标志位,表示该条数据是否通过有效性校验,传感器异常时会被标记为无效。 |
| pH值、PH | — | 水的酸碱度,取值 0–14,7 为中性;pH 异常通常指示工业废水混入。 |
| 浊度 | — | 水体浑浊程度,由悬浮颗粒对光的散射产生,间接反映悬浮物含量。 |
| 分流测量值 | — | 多指标分流器的分流状态测量值,用于判断旱流污水是否按设计分流至污水管。 |
| 留样量 | — | 采样器单次留取并分装入留样瓶的水样量;超标留样用于实验室比对复核。 |
| 称重传感器 | — | 留样瓶/采样桶的重量读数,用于核实留样量、检测样水异常流失。 |
| 备用 | — | 预留数据列,暂无实际业务含义。 |
接口描述
本接口为设备数据说明接口。
通过调用此接口可以获得数据接口中出现的字段名的物理意义与单位。
用户需要参考此接口来选取数据接口中返回的有用数据列,数据接口返回的数据列并不是全部对用户有意义
数据接口获取的数据有一些字段在此未作说明,那是普通用户可以直接丢弃的程序调试字段
每种设备类型中列字段的对应关系是不变的,开发者不需要为此做动态绑定
建议开发者获取一次数据后存储到自己系统数据库作为字典表使用
接口调用
-
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":"℃"}, ...... ] }, ...... ]
响应参数
| 参数名称 | 说明 |
|---|---|
| httpcode | 200-正常,401-无权限,500-其他错误。 |
| equipType | 设备类型编码 |
| equipLabel | 设备类型名称 |
| dataColumn | 数据列标识 |
| dataLabel | 数据列名称 |
| dataUnit | 数据单位 |
当无数据的时候返回:[ ]
内容来源于 THWater 官方开发文档查看原文
© 2026 THWater · 北京清环智慧水务科技有限公司