From 8af9d7041855eee2a45d525f0e4f75e8a458b0fd Mon Sep 17 00:00:00 2001 From: wangjialei <1178332920@qq.com> Date: Fri, 23 Jan 2026 13:59:40 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0api?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- dw统计(TaskApi).md | 38 ++++++++++++++++++++++++++++++++------ 1 file changed, 32 insertions(+), 6 deletions(-) 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