45 lines
2.7 KiB
Markdown
45 lines
2.7 KiB
Markdown
---
|
||
name: tjwater-action-data-timeseries-access-realtime
|
||
description: data/timeseries-access 下 realtime 操作技能。
|
||
version: 3.0.0
|
||
---
|
||
|
||
# realtime Action Skill
|
||
|
||
## 简介
|
||
负责 `data/timeseries-access` 场景下 `realtime` 的具体接口调用。
|
||
|
||
## 子模块索引 (渐进式引导)
|
||
- 当前为叶子节点，直接使用下方接口目录。
|
||
|
||
## 接口目录
|
||
| Method | Path | Summary | Required Params | Optional Params |
|
||
|---|---|---|---|---|
|
||
| DELETE | `/api/v1/realtime/links` | 删除实时管道数据 | start_time (query), end_time (query) | - |
|
||
| GET | `/api/v1/realtime/links` | 查询实时管道数据 | start_time (query), end_time (query) | - |
|
||
| POST | `/api/v1/realtime/links/batch` | 批量插入实时管道数据 | data (body) | - |
|
||
| PATCH | `/api/v1/realtime/links/{link_id}/field` | 更新实时管道字段 | link_id (path), time (query), field (query), value (query) | - |
|
||
| DELETE | `/api/v1/realtime/nodes` | 删除实时节点数据 | start_time (query), end_time (query) | - |
|
||
| GET | `/api/v1/realtime/nodes` | 查询实时节点数据 | start_time (query), end_time (query) | - |
|
||
| POST | `/api/v1/realtime/nodes/batch` | 批量插入实时节点数据 | data (body) | - |
|
||
| GET | `/api/v1/realtime/query/by-id-time` | 按ID和时间查询实时模拟数据 | id (query), type (query), query_time (query) | - |
|
||
| GET | `/api/v1/realtime/query/by-time-property` | 按时间和属性查询实时数据 | query_time (query), type (query), property (query) | - |
|
||
| POST | `/api/v1/realtime/simulation/store` | 存储实时模拟结果 | node_result_list (body), link_result_list (body), result_start_time (query) | - |
|
||
|
||
- 覆盖方法：`DELETE, GET, PATCH, POST`
|
||
|
||
## 接口说明
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| `POST /realtime/links/batch` | 批量将管道（link）模拟结果写入实时数据表（TimescaleDB） |
|
||
| `GET /realtime/links` | 查询指定时间范围内的实时管道模拟数据 |
|
||
| `DELETE /realtime/links` | 删除指定时间范围内的实时管道数据 |
|
||
| `PATCH /realtime/links/{link_id}/field` | 修改某条管道在特定时刻的某个字段值 |
|
||
| `POST /realtime/nodes/batch` | 批量将节点模拟结果写入实时数据表 |
|
||
| `GET /realtime/nodes` | 查询指定时间范围内的实时节点模拟数据 |
|
||
| `DELETE /realtime/nodes` | 删除指定时间范围内的实时节点数据 |
|
||
| `POST /realtime/simulation/store` | 一次性存储一次完整模拟运行的节点和管道结果（含起始时间） |
|
||
| `GET /realtime/query/by-time-property` | 按查询时间点和属性名（如 pressure/flow）查询全网实时模拟值 |
|
||
| `GET /realtime/query/by-id-time` | 按单个元素ID、类型和时间点查询其实时模拟值 |
|