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³
},{},{}] //其他表数据
}
}