|
|
|
|
@ -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：初版 |
