diff --git a/dw统计(TaskApi).md b/dw统计(TaskApi).md index d10eb5c..f14682d 100644 --- a/dw统计(TaskApi).md +++ b/dw统计(TaskApi).md @@ -1,6 +1,6 @@ -# 接口名称:重新计算`DW`数据 +# 接口名称:重新计算小时`DW`数据 -- 接口路径:`GET /api/energy/realtime` +- 接口路径:`GET /api/TakeDataV03/SaveProjectRealHourDW` - 适用范围:云端 / 客户现场 - 最早版本:v1.0.0 - 最新变更:v1.2.0 @@ -11,15 +11,41 @@ | 参数 | 类型 | 必填 | 说明 | |----|----|----|----| | projectId | string | 是 | 项目ID | -| meterId | string | 是 | 表计ID | +| startTime | time | 是 | 开始时间 | +| etartTime | time | 是 | 截止时间 | +| pointIds | [long] | 否 | 点位 | ## 返回结果 ```json { - "value": 123.45, - "unit": "kWh", - "time": "2026-01-22 10:00:00" + "projectId": 123, + "startTime": "2026-01-22 00:00:00", + "etartTime": "2026-01-22 10:00:00" } ``` ## 使用说明 + +* 何时调用 +1. 小时能耗不存在或计算错误,需要重新计算 +2. `5`分钟历史数据手动修改或补数后 +* 执行方式 +1. 使用`Postman`等第三方工具 +2. `shell`命令实例 +```sh +wget \ + --header="Content-Type: application/json" \ + --post-data='{"ProjectId":513483640334377,"StartTime":"2025-12-10","EndTime":"2025-12-10"}' \ + http://localhost:5005/api/TakeDataV03/SaveProjectRealHourDW +``` +* 注意事项 +依赖`5`分钟历史数据 +* 客户差异说明 +无 + +## 变更历史 + +* v1.2.0: +> 获取统计周期内的两头数据,而不是特定时间的数据 +> 如果初读数不是00分钟,则向前找最近时刻数据,统计少数 +* v1.0.0:初版 \ No newline at end of file