62 lines
4.1 KiB
Markdown
62 lines
4.1 KiB
Markdown
---
|
|
name: tjwater-action-business-network-assets-tanks
|
|
description: business/network-assets 下 tanks 操作技能。
|
|
version: 3.0.0
|
|
---
|
|
|
|
# tanks Action Skill
|
|
|
|
## 简介
|
|
负责 `business/network-assets` 场景下 `tanks` 的具体接口调用。
|
|
|
|
## 子模块索引 (渐进式引导)
|
|
- 当前为叶子节点,直接使用下方接口目录。
|
|
|
|
## 接口目录
|
|
| Method | Path | Summary | Required Params | Optional Params |
|
|
|---|---|---|---|---|
|
|
| POST | `/api/v1/addtank/` | 新增水箱 | network (query), tank (query), x (query), y (query), elevation (query) | init_level (query), min_level (query), max_level (query), diameter (query), min_vol (query) |
|
|
| POST | `/api/v1/deletetank/` | 删除水箱 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/getalltankproperties/` | 获取所有水箱属性 | network (query) | - |
|
|
| GET | `/api/v1/gettankcoord/` | 获取水箱坐标 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankdiameter/` | 获取水箱直径 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankelevation/` | 获取水箱标高 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankinitlevel/` | 获取水箱初始水位 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankmaxlevel/` | 获取水箱最大水位 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankminlevel/` | 获取水箱最小水位 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankminvol/` | 获取水箱最小体积 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankoverflow/` | 获取水箱溢流口 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankproperties/` | 获取水箱属性 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankschema` | 获取水箱模式 | network (query) | - |
|
|
| GET | `/api/v1/gettankvolcurve/` | 获取水箱容积曲线 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettankx/` | 获取水箱X坐标 | network (query), tank (query) | - |
|
|
| GET | `/api/v1/gettanky/` | 获取水箱Y坐标 | network (query), tank (query) | - |
|
|
| POST | `/api/v1/settankcoord/` | 设置水箱坐标 | network (query), tank (query), x (query), y (query) | - |
|
|
| POST | `/api/v1/settankdiameter/` | 设置水箱直径 | network (query), tank (query), diameter (query) | - |
|
|
| POST | `/api/v1/settankelevation/` | 设置水箱标高 | network (query), tank (query), elevation (query) | - |
|
|
| POST | `/api/v1/settankinitlevel/` | 设置水箱初始水位 | network (query), tank (query), init_level (query) | - |
|
|
| POST | `/api/v1/settankmaxlevel/` | 设置水箱最大水位 | network (query), tank (query), max_level (query) | - |
|
|
| POST | `/api/v1/settankminlevel/` | 设置水箱最小水位 | network (query), tank (query), min_level (query) | - |
|
|
| POST | `/api/v1/settankminvol/` | 设置水箱最小体积 | network (query), tank (query), min_vol (query) | - |
|
|
| POST | `/api/v1/settankoverflow/` | 设置水箱溢流口 | network (query), tank (query), overflow (query) | - |
|
|
| POST | `/api/v1/settankproperties/` | 设置水箱属性 | network (query), tank (query) | - |
|
|
| POST | `/api/v1/settankvolcurve/` | 设置水箱容积曲线 | network (query), tank (query), vol_curve (query) | - |
|
|
| POST | `/api/v1/settankx/` | 设置水箱X坐标 | network (query), tank (query), x (query) | - |
|
|
| POST | `/api/v1/settanky/` | 设置水箱Y坐标 | network (query), tank (query), y (query) | - |
|
|
|
|
- 覆盖方法:`GET, POST`
|
|
|
|
## 接口说明
|
|
|
|
| 接口 | 说明 |
|
|
|---|---|
|
|
| `GET /gettankschema` | 返回水箱(Tank)数据模型的所有字段定义 |
|
|
| `GET /gettankproperties/` | 查询单个水箱的所有属性(标高、直径、初始/最大/最小水位等) |
|
|
| `GET /getalltankproperties/` | 批量获取管网中所有水箱的属性列表 |
|
|
| `GET /gettankelevation/` | 查询水箱底部标高 |
|
|
| `GET /gettankdiameter/` | 查询水箱直径 |
|
|
| `GET /gettankinitlevel/` | 查询水箱初始水位 |
|
|
| `POST /addtank/` | 向管网添加一个新水箱,需提供ID、坐标、标高和水位参数 |
|
|
| `POST /deletetank/` | 从管网删除指定水箱 |
|
|
| `POST /settank*/` | 设置水箱某个具体属性(坐标、标高、直径、水位等) |
|