Appearance
水表能耗数据
小时区间范围限制：24小时 （接口支持获取最近3个月内数据）
日区间范围限制：31天 （接口支持获取最近12个月内数据）
月区间范围限制：12个月
年区间范围限制：12年
接口严格限流： 年、月统计数据每天调用次数为 每天10次 ，日和小时统计数据每天24次。
每次获取该区间所有设备数据结果，如需要不同维度（比如按照时间聚合，按照标签，聚合等）数据，应根据已提供的数值自行计算即可。
常见问题
常见问题
- 水表一般是按天或者周更新数据，所以一般是没有小时维度的数据的，按周更新的表就不会每天都有数据。
- 部分水表数据是随机上报的时间可能会是乱的
- 预期时间段内没有数据 检查下系统中的定时抄表/上报
- 抄表/上报 时间受信号，通讯质量 影响做不到完全准时（不重要）
- 可以先了解下 产品
不同维度数据接口地址 ⭐
| 时间维度 | 请求路径 | 注意 |
|---|---|---|
| 小时 | GET /Api/StatisticWater/hour | 系统中要设置小时级别的 定时抄表 |
| 天 | GET /Api/StatisticWater/day | |
| 月 | GET /Api/StatisticWater/month | |
| 年 | GET /Api/StatisticWater/year |
参数示例
json
{
auth:"123",//必填
start_time:"" //必填 格式：小时(2024081600) ，日(20240816)，月（202408），年（2024）
end_time:"",//必填 格式同上要求end_time大于等于start_time
}响应字段释义
| 字段 | 说明 |
|---|---|
| mid | 档案id，对应 查询设备列表和当前状态 中的id |
| s | 开始数据，表示起始值（单位：m³） |
| st | 开始数据的来源时间 |
| e | 结束数据，表示结束值（单位：m³） |
| et | 结束数据的来源时间 |
| d | 区间差值，表示开始与结束的数值差异（单位：m³） |
返回示例
json
#### 小时维度
{
status:1 //1成功 0失败
msg:"",//失败原因
data:{
"2024081600":[{ // 时间
//mid 对应 [查询设备列表和当前状态](/doc/datas/device#id) 里的id，如果表被删除，则<查询设备列表和当前状态>里可能不存在对应id的表档案数据
"mid":1000 ，
"s":1,//表示start,开始数据 单位m³
"st":"2024-08-16 00:05",//开始数据来源时间
"e":2,//表示end,结束数据 单位m³
"et":"2024-08-16 01:03",//结束数据来源时间
"d":1,//表示diff,区间差值 单位m³
},{},{}], //其他表数据
"2024081601":[{
//mid 对应<查询设备列表和当前状态>里的id，如果表被删除，则<查询设备列表和当前状态>里可能不存在对应id的表档案数据
"mid":1000 ，
"s":1,//表示start,开始数据 单位m³
"st":"2024-08-16 01:05",//开始数据来源时间
"e":2,//表示end,结束数据 单位m³
"et":"2024-08-16 02:03",//结束数据来源时间
"d":1,//表示diff,区间差值 单位m³
},{},{}] //其他表数据
}
}json
#### 日维度
{
"status": 1,
"data": {
"20250320": [
{
"mid": 2324809,
"st": "2025/3/19 23:52:48",
"et": "2025/3/20 23:53:01",
"d": 76.5,
"s": 39216.36,
"e": 39292.86
},
...
],
"20250319": [
{
"mid": 2324809,
"st": "2025/3/19 23:52:48",
"et": "2025/3/20 23:53:01",
"d": 76.5,
"s": 39216.36,
"e": 39292.86
},
...
]
}
}json
#### 月维度
{
"status": 1,
"data": {
"202503": [
{
"mid": 2324896,
"st": "2025/2/28 9:59:24",
"et": "2025/3/31 23:57:57",
"d": 1886,
"s": 42455,
"e": 44341
},
...
],
"202502": [
{
"mid": 2324896,
"st": "2025/2/28 9:59:24",
"et": "2025/3/31 23:57:57",
"d": 1886,
"s": 42455,
"e": 44341
},
...
]
}
}json
#### 年维度
{
"status": 1,
"data": {
"2023": [
{
"mid": 2329439,
"st": "2023/3/31 11:06:25",
"et": "2023/12/28 0:09:19",
"d": 53136,
"s": 2717,
"e": 55853
},
...
],
"2024"[{
"mid": 2324901,
"st": "2024/1/1 0:01:27",
"et": "2024/4/18 9:50:17",
"d": 0,
"s": 246.36,
"e": 246.36
}
...
]
}
}提示
- 没数据？
- 检查参数，系统中有没有添加设备，设备运行了多长时间，有没有设置定时抄表
- 系统中有没有数据，联系售后给你看看后台
- 按日抄表才有日数据