流量计&压力推送API接口文档

流量计&压力API接口文档

基本信息

项目名称: 智慧水务-分区计量系统
版本号: v1.0
修订日期: 2025-05-30
接口类型: JSON报文传输
协议支持: HTTPS
接口说明: 通过JSON报文批量接收水表的瞬时流量、累计流量、管道压力等实时数据

请求方式

方法	URL	编码
POST	https://www.hehuitech.cn/water-api/api/flow-meters	UTF-8

请求头

参数	类型	必选	说明
Client-Id	String	是	身份认证ID（需由租户或运营人员提供，示例：`649495e7f3489ad9d08c1392cdae5d97`）

请求体示例


[
  {
    "stationNo": "CS000001",
    "name": "测试数据",
    "flowMeterNo": "CS000001",
    "flowMeterName": "测试水表",
    "no": "CS000001",
    "sim": "CS000001",
    "factory": "厂商",
    "address": "-",
    "diameter": "-",
    "datas": [
      {
        "collectTime": "2025-05-30 10:15:00",
        "flowRate": 20.8,
        "forwardFlow": 586744.5,
        "reverseFlow": 3864.2,
        "pressure": 2.1
      },
      {
        "collectTime": "2025-05-29 10:20:00",
        "flowRate": 21.3,
        "forwardFlow": 586765.8,
        "reverseFlow": 3864.2,
        "pressure": 2.2
      }
    ]
  }
]

字段说明

主字段

字段	类型	单位	必填	说明
stationNo	String	-	否	站点编号（建议填写）
name	String	-	否	站点名称（建议填写）
flowMeterNo	String	-	是	水表编码（设备唯一标识）
flowMeterName	String	-	是	水表名称
no	String	-	否	注册码（无则填写水表编码）
sim	String	-	否	物联网SIM卡号
factory	String	-	是	水表厂商名称
address	String	-	否	安装地址（水司提供，建议填写）
diameter	String	-	否	水表口径（建议填写）
datas	List	-	是	采集数据列表（详见下方Data字段说明）

Data字段

字段	类型	单位	必填	说明
collectTime	String	-	是	采集时间（格式：`yyyy-MM-dd HH:mm:ss`）
flowRate	BigDecimal	t/h	否	瞬时流量（流量计选配）
forwardFlow	BigDecimal	t	否	正向累积量（流量计选配）
reverseFlow	BigDecimal	t	否	反向累积量（流量计选配）
cleanFlow	BigDecimal	t	否	净累积量（正向－反向，不建议填写）
pressure	BigDecimal	MPa	否	压力（压力表/传感器选配）

响应规范

成功响应


xxxxxxxxxx
{
  "code": 0,
  "message": "操作成功",
  "data": 2,
  "requestId": "dfaa1b28-6748-493e-9dcc-ac5423892b15"
}

错误响应

1. 请求头中缺少Client-Id


xxxxxxxxxx
{
  "code": 400121,
  "message": "请求头中Client-Id不存在,请检查",
  "data": null,
  "requestId": "bff142f0-12f5-4202-ae85-8b84758f7c5a"
}

2. Client-Id输入错误


xxxxxxxxxx
{
  "code": 400122,
  "message": "Client-Id异常，请联系水司获取正确的Client-Id！",
  "data": null,
  "requestId": "ba03f3bc-16a7-4f19-95e5-ceb2531b7b3c"
}

3. 必填数据为空


xxxxxxxxxx
{
  "code": 400,
  "message": "[list[0].flowMeterName:水表名称不为空]",
  "data": null,
  "requestId": "9287359e-f66a-41da-9d99-d58be5143280"
}

4. 系统错误


xxxxxxxxxx
{
  "code": 500,
  "message": "系统繁忙,请稍后再试",
  "data": null,
  "requestId": "e0f37e98-6819-406a-8051-8f198fb0d5ad"
}

状态码对照表

代码	含义	处理建议
0	发送成功	与系统相关工作人员核实数据
400121	请求头中缺少Client-Id	请检查请求头中是否添加`Client-Id`
400122	Client-Id错误	与系统相关工作人员获取正确ID
400	缺少必填参数	补全必填参数（如`flowMeterName`）
500	系统错误	1. 检查传输的JSON是否正确 2. 若JSON正确，请联系系统相关人员