文档HTTP 数据接口设备数据说明
HTTP 数据接口

设备数据说明

更新于 2022-08-29

设备数据说明

以下为完整的设备数据字典,按设备类型列出数据接口各数据列(c1–c30)的物理意义与单位。

类型 1 · 液位仪(压力)

数据列含义单位
c1中继电压v
c2电压v
c10液位m
c13井内温度℃
c14中继温度℃
c15中继湿度%
c16环境温度℃
c17环境湿度%
c20设备电量百分比%

常用字段单位对照

字段单位备注
流量L/s单位时间内通过监测断面的水体体积,是排水管网流量监测的核心指标。
流速m/s水流通过监测断面的平均速度,与液位结合可推算过流断面面积与流量。
液位m水面相对于设备安装基准点的高度,用于判断积水深度与满管、溢流风险。
温度、井内温度、水温℃水体温度,影响水中生物活性、化学反应速率与溶解氧含量。
设备电量百分比%设备电池剩余电量百分比,用于运维判断是否需要更换电池。
电导率μS/cm水体传导电流的能力,反映溶解性离子总量,可间接判断水体污染或盐分变化。
CODmg/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)mVORP = 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
    

调用参数

参数名称必填说明
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数据单位

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