Files
TJWaterServerBinary/.github/skills/api-spec.md
T
2026-03-27 13:05:22 +08:00

672 lines
31 KiB
Markdown

# API Skills 索引(领域 -> 场景 -> 操作)
说明:操作层 Action 以 endpoint 模块为单位。
## ai/copilot-assistant
### Action: `copilot`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/copilot/chat/stream` | Copilot 聊天流式响应 |
## analytics/scada-operations
### Action: `scada`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addscadadevice/` | 添加SCADA设备 |
| POST | `/api/v1/addscadadevicedata/` | 添加SCADA设备数据 |
| POST | `/api/v1/addscadaelement/` | 添加SCADA元素映射 |
| POST | `/api/v1/cleanscadadevice/` | 清空SCADA设备表 |
| POST | `/api/v1/cleanscadadevicedata/` | 清空SCADA设备数据表 |
| POST | `/api/v1/cleanscadaelement/` | 清空SCADA元素映射表 |
| POST | `/api/v1/deletescadadevice/` | 删除SCADA设备 |
| POST | `/api/v1/deletescadadevicedata/` | 删除SCADA设备数据 |
| POST | `/api/v1/deletescadaelement/` | 删除SCADA元素映射 |
| GET | `/api/v1/getallscadadeviceids/` | 获取所有SCADA设备ID |
| GET | `/api/v1/getallscadadevices/` | 获取所有SCADA设备 |
| GET | `/api/v1/getallscadainfo/` | 获取所有SCADA信息 |
| GET | `/api/v1/getallscadaproperties/` | 获取所有SCADA属性 |
| GET | `/api/v1/getscadadevice/` | 获取SCADA设备 |
| GET | `/api/v1/getscadadevicedata/` | 获取SCADA设备数据 |
| GET | `/api/v1/getscadadevicedataschema/` | 获取SCADA设备数据架构 |
| GET | `/api/v1/getscadadeviceschema/` | 获取SCADA设备架构 |
| GET | `/api/v1/getscadaelement/` | 获取单个SCADA元素映射 |
| GET | `/api/v1/getscadaelements/` | 获取所有SCADA元素映射 |
| GET | `/api/v1/getscadaelementschema/` | 获取SCADA元素架构 |
| GET | `/api/v1/getscadainfo/` | 获取SCADA信息 |
| GET | `/api/v1/getscadainfoschema/` | 获取SCADA信息架构 |
| GET | `/api/v1/getscadaproperties/` | 获取SCADA属性 |
| POST | `/api/v1/scada/batch` | 批量插入SCADA监测数据 |
| DELETE | `/api/v1/scada/by-id-time-range` | 按设备ID和时间范围删除SCADA数据 |
| GET | `/api/v1/scada/by-ids-field-time-range` | 按设备ID、字段和时间范围查询SCADA数据 |
| GET | `/api/v1/scada/by-ids-time-range` | 按设备ID和时间范围查询SCADA数据 |
| PATCH | `/api/v1/scada/{device_id}/field` | 更新SCADA设备字段 |
| POST | `/api/v1/setscadadevice/` | 更新SCADA设备 |
| POST | `/api/v1/setscadadevicedata/` | 更新SCADA设备数据 |
| POST | `/api/v1/setscadaelement/` | 更新SCADA元素映射 |
## analytics/simulation-analysis
### Action: `burst_detection`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/burst-detection/detect/` | 执行爆管检测 |
| GET | `/api/v1/burst-detection/schemes/` | 查询爆管检测方案列表 |
| GET | `/api/v1/burst-detection/schemes/{scheme_name}` | 获取爆管检测方案详情 |
### Action: `burst_location`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/burst-location/locate/` | 执行爆管定位 |
| GET | `/api/v1/burst-location/schemes/` | 查询爆管定位方案列表 |
| GET | `/api/v1/burst-location/schemes/{scheme_name}` | 获取爆管定位方案详情 |
### Action: `leakage`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/leakage/identify/` | 执行漏损识别 |
| GET | `/api/v1/leakage/schemes/` | 查询漏损识别方案列表 |
| GET | `/api/v1/leakage/schemes/{scheme_name}` | 获取漏损识别方案详情 |
### Action: `risk`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getnetworkpiperiskprobabilitynow/` | 获取整个网络的管道风险概率 |
| GET | `/api/v1/getpiperiskprobability/` | 获取管道风险概率历史 |
| GET | `/api/v1/getpiperiskprobabilitygeometries/` | 获取管道风险几何信息 |
| GET | `/api/v1/getpiperiskprobabilitynow/` | 获取管道当前风险概率 |
| GET | `/api/v1/getpipesriskprobability/` | 批量获取多条管道风险概率 |
### Action: `simulation`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/age_analysis/` | 水龄分析(高级) |
| GET | `/api/v1/ageanalysis/` | 水龄分析(基础) |
| GET | `/api/v1/burst_analysis/` | 爆管分析(高级) |
| GET | `/api/v1/burstanalysis/` | 爆管分析(基础) |
| GET | `/api/v1/contaminant_simulation/` | 污染物模拟 |
| POST | `/api/v1/daily_scheduling_analysis/` | 日排程分析 |
| GET | `/api/v1/dumpoutput/` | 导出模拟输出 |
| GET | `/api/v1/flushing_analysis/` | 冲洗分析(高级) |
| GET | `/api/v1/flushinganalysis/` | 冲洗分析(基础) |
| POST | `/api/v1/network_project/` | 导入网络项目 |
| POST | `/api/v1/network_update/` | 管网更新(高级) |
| GET | `/api/v1/networkupdate/` | 管网更新(基础) |
| POST | `/api/v1/pressure_regulation/` | 压力调节(高级) |
| POST | `/api/v1/pressure_sensor_placement_kmeans/` | 压力传感器放置-KMeans聚类分析(高级) |
| POST | `/api/v1/pressure_sensor_placement_sensitivity/` | 压力传感器放置-灵敏度分析(高级) |
| GET | `/api/v1/pressureregulation/` | 压力调节(基础) |
| GET | `/api/v1/pressuresensorplacementkmeans/` | 压力传感器放置-KMeans聚类分析(基础) |
| GET | `/api/v1/pressuresensorplacementsensitivity/` | 压力传感器放置-灵敏度分析(基础) |
| POST | `/api/v1/project_management/` | 项目管理(高级) |
| GET | `/api/v1/projectmanagement/` | 项目管理(基础) |
| POST | `/api/v1/pump_failure/` | 泵故障管理 |
| GET | `/api/v1/runinp/` | 运行INP文件 |
| GET | `/api/v1/runproject/` | 运行项目模拟 |
| GET | `/api/v1/runprojectreturndict/` | 运行项目模拟(返回字典) |
| POST | `/api/v1/runsimulationmanuallybydate/` | 手动运行日期指定模拟 |
| POST | `/api/v1/scheduling_analysis/` | 排程分析 |
| POST | `/api/v1/sensorplacementscheme/create` | 传感器放置方案创建 |
| GET | `/api/v1/valve_close_analysis/` | 阀门关闭分析(高级) |
| GET | `/api/v1/valve_isolation_analysis/` | 阀门隔离分析 |
| GET | `/api/v1/valvecloseanalysis/` | 阀门关闭分析(基础) |
## business/component-config
### Action: `controls`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getcontrolproperties/` | 获取控制属性 |
| GET | `/api/v1/getcontrolschema/` | 获取控制架构 |
| GET | `/api/v1/getruleproperties/` | 获取规则属性 |
| GET | `/api/v1/getruleschema/` | 获取规则架构 |
| POST | `/api/v1/setcontrolproperties/` | 设置控制属性 |
| POST | `/api/v1/setruleproperties/` | 设置规则属性 |
### Action: `curves`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addcurve/` | 添加曲线 |
| POST | `/api/v1/deletecurve/` | 删除曲线 |
| GET | `/api/v1/getcurveproperties/` | 获取曲线属性 |
| GET | `/api/v1/getcurves/` | 获取所有曲线 |
| GET | `/api/v1/getcurveschema` | 获取曲线架构 |
| GET | `/api/v1/iscurve/` | 检查曲线存在性 |
| POST | `/api/v1/setcurveproperties/` | 设置曲线属性 |
### Action: `options`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getenergyproperties/` | 获取能耗选项属性 |
| GET | `/api/v1/getenergyschema/` | 获取能耗选项架构 |
| GET | `/api/v1/getoptionproperties/` | 获取选项属性 |
| GET | `/api/v1/getoptionschema/` | 获取选项架构 |
| GET | `/api/v1/getpumpenergyproperties/` | 获取泵能耗属性 |
| GET | `/api/v1/getpumpenergyschema/` | 获取泵能耗选项架构 |
| GET | `/api/v1/gettimeproperties/` | 获取时间选项属性 |
| GET | `/api/v1/gettimeschema` | 获取时间选项架构 |
| POST | `/api/v1/setenergyproperties/` | 设置能耗选项属性 |
| POST | `/api/v1/setoptionproperties/` | 设置选项属性 |
| GET | `/api/v1/setpumpenergyproperties/` | 设置泵能耗属性 |
| POST | `/api/v1/settimeproperties/` | 设置时间选项属性 |
### Action: `patterns`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addpattern/` | 添加模式 |
| POST | `/api/v1/deletepattern/` | 删除模式 |
| GET | `/api/v1/getpatternproperties/` | 获取模式属性 |
| GET | `/api/v1/getpatterns/` | 获取所有模式 |
| GET | `/api/v1/getpatternschema` | 获取模式架构 |
| GET | `/api/v1/ispattern/` | 检查模式存在性 |
| POST | `/api/v1/setpatternproperties/` | 设置模式属性 |
### Action: `quality`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addmixing/` | 添加混合 |
| POST | `/api/v1/addsource/` | 添加水源 |
| POST | `/api/v1/deletemixing/` | 删除混合 |
| POST | `/api/v1/deletesource/` | 删除水源 |
| GET | `/api/v1/getemitterproperties/` | 获取发射器属性 |
| GET | `/api/v1/getemitterschema` | 获取发射器架构 |
| GET | `/api/v1/getmixing/` | 获取混合属性 |
| GET | `/api/v1/getmixingschema/` | 获取混合架构 |
| GET | `/api/v1/getpipereaction/` | 获取管道反应属性 |
| GET | `/api/v1/getpipereactionschema/` | 获取管道反应架构 |
| GET | `/api/v1/getqualityproperties/` | 获取水质属性 |
| GET | `/api/v1/getqualityschema/` | 获取水质架构 |
| GET | `/api/v1/getreaction/` | 获取反应属性 |
| GET | `/api/v1/getreactionschema/` | 获取反应架构 |
| GET | `/api/v1/getsource/` | 获取水源属性 |
| GET | `/api/v1/getsourcechema/` | 获取水源架构 |
| GET | `/api/v1/gettankreaction/` | 获取水池反应属性 |
| GET | `/api/v1/gettankreactionschema/` | 获取水池反应架构 |
| POST | `/api/v1/setemitterproperties/` | 设置发射器属性 |
| POST | `/api/v1/setmixing/` | 设置混合属性 |
| POST | `/api/v1/setpipereaction/` | 设置管道反应属性 |
| POST | `/api/v1/setqualityproperties/` | 设置水质属性 |
| POST | `/api/v1/setreaction/` | 设置反应属性 |
| POST | `/api/v1/setsource/` | 设置水源属性 |
| POST | `/api/v1/settankreaction/` | 设置水池反应属性 |
### Action: `visuals`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addlabel/` | 添加标签 |
| POST | `/api/v1/addvertex/` | 添加图形元素 |
| POST | `/api/v1/deletelabel/` | 删除标签 |
| POST | `/api/v1/deletevertex/` | 删除图形元素 |
| GET | `/api/v1/getallvertexlinks/` | 获取所有图形元素链接 |
| GET | `/api/v1/getallvertices/` | 获取所有图形元素 |
| GET | `/api/v1/getbackdropproperties/` | 获取背景属性 |
| GET | `/api/v1/getbackdropschema/` | 获取背景架构 |
| GET | `/api/v1/getlabelproperties/` | 获取标签属性 |
| GET | `/api/v1/getlabelschema/` | 获取标签架构 |
| GET | `/api/v1/getvertexproperties/` | 获取图形元素属性 |
| GET | `/api/v1/getvertexschema/` | 获取图形元素架构 |
| POST | `/api/v1/setbackdropproperties/` | 设置背景属性 |
| POST | `/api/v1/setlabelproperties/` | 设置标签属性 |
| POST | `/api/v1/setvertexproperties/` | 设置图形元素属性 |
## business/identity-access
### Action: `auth`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/auth/login` | login |
| POST | `/api/v1/auth/login/simple` | login_simple |
| GET | `/api/v1/auth/me` | get_current_user_info |
| POST | `/api/v1/auth/refresh` | refresh_token |
| POST | `/api/v1/auth/register` | register |
### Action: `user_management`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/users/` | 列出所有用户 |
| DELETE | `/api/v1/users/{user_id}` | 删除用户 |
| GET | `/api/v1/users/{user_id}` | 获取用户详情 |
| PUT | `/api/v1/users/{user_id}` | 更新用户信息 |
| POST | `/api/v1/users/{user_id}/activate` | 激活用户 |
| POST | `/api/v1/users/{user_id}/deactivate` | 停用用户 |
### Action: `users`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getallusers/` | 获取所有用户 |
| GET | `/api/v1/getuser/` | 获取单个用户 |
| GET | `/api/v1/getuserschema/` | 获取用户模式 |
## business/network-assets
### Action: `demands`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/calculatedemandtonetwork/` | 计算需水量到整网分配 |
| GET | `/api/v1/calculatedemandtonodes/` | 计算需水量到节点分配 |
| GET | `/api/v1/calculatedemandtoregion/` | 计算需水量到区域分配 |
| GET | `/api/v1/getdemandproperties/` | 获取需水量属性 |
| GET | `/api/v1/getdemandschema` | 获取需水量属性架构 |
| POST | `/api/v1/setdemandproperties/` | 设置需水量属性 |
### Action: `general`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/deletelink/` | 删除管线 |
| POST | `/api/v1/deletenode/` | 删除节点 |
| GET | `/api/v1/getallscadaproperties/` | 获取所有SCADA点属性 |
| GET | `/api/v1/getelementproperties/` | 获取元素属性 |
| GET | `/api/v1/getelementpropertieswithtype/` | 获取指定类型元素属性 |
| GET | `/api/v1/getelementtype/` | 获取元素类型 |
| GET | `/api/v1/getelementtypevalue/` | 获取元素类型值 |
| GET | `/api/v1/getlinkproperties/` | 获取管线属性 |
| GET | `/api/v1/getlinks/` | 获取所有管线 |
| GET | `/api/v1/getlinktype/` | 获取管线类型 |
| GET | `/api/v1/getnodelinks/` | 获取节点的关联管线 |
| GET | `/api/v1/getnodeproperties/` | 获取节点属性 |
| GET | `/api/v1/getnodes/` | 获取所有节点 |
| GET | `/api/v1/getnodetype/` | 获取节点类型 |
| GET | `/api/v1/getscadaproperties/` | 获取SCADA点属性 |
| GET | `/api/v1/getstatus/` | 获取管线状态 |
| GET | `/api/v1/getstatusschema` | 获取状态属性架构 |
| GET | `/api/v1/gettitle/` | 获取水网标题属性 |
| GET | `/api/v1/gettitleschema/` | 获取标题属性架构 |
| GET | `/api/v1/isjunction/` | 检查是否为接点 |
| GET | `/api/v1/islink/` | 检查管线有效性 |
| GET | `/api/v1/isnode/` | 检查节点有效性 |
| GET | `/api/v1/ispipe/` | 检查是否为管道 |
| GET | `/api/v1/ispump/` | 检查是否为泵 |
| GET | `/api/v1/isreservoir/` | 检查是否为水源 |
| GET | `/api/v1/istank/` | 检查是否为蓄水池 |
| GET | `/api/v1/isvalve/` | 检查是否为阀门 |
| POST | `/api/v1/setstatus/` | 设置管线状态 |
| GET | `/api/v1/settitle/` | 设置水网标题属性 |
### Action: `geometry`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getmajornodecoords/` | 获取主要节点坐标 |
| GET | `/api/v1/getmajorpipenodes/` | 获取主要管道节点 |
| GET | `/api/v1/getnetworkgeometries/` | 获取完整网络几何信息 |
| GET | `/api/v1/getnetworkinextent/` | 获取范围内的网络元素 |
| GET | `/api/v1/getnetworklinknodes/` | 获取网络管线节点 |
| GET | `/api/v1/getnodecoord/` | 获取节点坐标 |
### Action: `junctions`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addjunction/` | 添加节点 |
| POST | `/api/v1/deletejunction/` | 删除节点 |
| GET | `/api/v1/getalljunctionproperties/` | 获取所有节点属性 |
| GET | `/api/v1/getjunctioncoord/` | 获取节点坐标 |
| GET | `/api/v1/getjunctiondemand/` | 获取节点需水量 |
| GET | `/api/v1/getjunctionelevation/` | 获取节点标高 |
| GET | `/api/v1/getjunctionpattern/` | 获取节点需水模式 |
| GET | `/api/v1/getjunctionproperties/` | 获取节点属性 |
| GET | `/api/v1/getjunctionschema` | 获取节点架构 |
| GET | `/api/v1/getjunctionx/` | 获取节点 X 坐标 |
| GET | `/api/v1/getjunctiony/` | 获取节点 Y 坐标 |
| POST | `/api/v1/setjunctioncoord/` | 设置节点坐标 |
| POST | `/api/v1/setjunctiondemand/` | 设置节点需水量 |
| POST | `/api/v1/setjunctionelevation/` | 设置节点标高 |
| POST | `/api/v1/setjunctionpattern/` | 设置节点需水模式 |
| POST | `/api/v1/setjunctionproperties/` | 批量设置节点属性 |
| POST | `/api/v1/setjunctionx/` | 设置节点 X 坐标 |
| POST | `/api/v1/setjunctiony/` | 设置节点 Y 坐标 |
### Action: `pipes`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addpipe/` | 添加管道 |
| POST | `/api/v1/deletepipe/` | 删除管道 |
| GET | `/api/v1/getallpipeproperties/` | 获取所有管道属性 |
| GET | `/api/v1/getpipediameter/` | 获取管道管径 |
| GET | `/api/v1/getpipelength/` | 获取管道长度 |
| GET | `/api/v1/getpipeminorloss/` | 获取管道局部阻力系数 |
| GET | `/api/v1/getpipenode1/` | 获取管道起始节点 |
| GET | `/api/v1/getpipenode2/` | 获取管道终止节点 |
| GET | `/api/v1/getpipeproperties/` | 获取管道属性 |
| GET | `/api/v1/getpiperoughness/` | 获取管道粗糙度 |
| GET | `/api/v1/getpipeschema` | 获取管道模式 |
| GET | `/api/v1/getpipestatus/` | 获取管道状态 |
| POST | `/api/v1/setpipediameter/` | 设置管道管径 |
| POST | `/api/v1/setpipelength/` | 设置管道长度 |
| POST | `/api/v1/setpipeminorloss/` | 设置管道局部阻力系数 |
| POST | `/api/v1/setpipenode1/` | 设置管道起始节点 |
| POST | `/api/v1/setpipenode2/` | 设置管道终止节点 |
| POST | `/api/v1/setpipeproperties/` | 设置管道属性 |
| POST | `/api/v1/setpiperoughness/` | 设置管道粗糙度 |
| POST | `/api/v1/setpipestatus/` | 设置管道状态 |
### Action: `pumps`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addpump/` | 添加水泵 |
| POST | `/api/v1/deletepump/` | 删除水泵 |
| GET | `/api/v1/getallpumpproperties/` | 获取所有水泵属性 |
| GET | `/api/v1/getpumpnode1/` | 获取水泵起始节点 |
| GET | `/api/v1/getpumpnode2/` | 获取水泵终止节点 |
| GET | `/api/v1/getpumpproperties/` | 获取水泵属性 |
| GET | `/api/v1/getpumpschema` | 获取水泵模式 |
| POST | `/api/v1/setpumpnode1/` | 设置水泵起始节点 |
| POST | `/api/v1/setpumpnode2/` | 设置水泵终止节点 |
| POST | `/api/v1/setpumpproperties/` | 设置水泵属性 |
### Action: `regions`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/adddistrictmeteringarea/` | 添加新DMA |
| POST | `/api/v1/addregion/` | 添加新区域 |
| POST | `/api/v1/addservicearea/` | 添加新服务区 |
| POST | `/api/v1/addvirtualdistrict/` | 添加新虚拟分区 |
| GET | `/api/v1/calculatedistrictmeteringarea/` | 计算DMA分区 |
| GET | `/api/v1/calculatedistrictmeteringareafornetwork/` | 计算整网DMA分区 |
| GET | `/api/v1/calculatedistrictmeteringareafornodes/` | 计算节点DMA分区 |
| GET | `/api/v1/calculatedistrictmeteringareaforregion/` | 计算区域内DMA分区 |
| GET | `/api/v1/calculateregion/` | 计算区域 |
| GET | `/api/v1/calculateservicearea/` | 计算服务区 |
| GET | `/api/v1/calculatevirtualdistrict/` | 计算虚拟分区 |
| POST | `/api/v1/deletedistrictmeteringarea/` | 删除DMA |
| POST | `/api/v1/deleteregion/` | 删除区域 |
| POST | `/api/v1/deleteservicearea/` | 删除服务区 |
| POST | `/api/v1/deletevirtualdistrict/` | 删除虚拟分区 |
| POST | `/api/v1/generatedistrictmeteringarea/` | 生成DMA分区 |
| POST | `/api/v1/generateregion/` | 生成区域分区 |
| POST | `/api/v1/generateservicearea/` | 生成服务区分区 |
| POST | `/api/v1/generatesubdistrictmeteringarea/` | 生成DMA子分区 |
| POST | `/api/v1/generatevirtualdistrict/` | 生成虚拟分区 |
| GET | `/api/v1/getalldistrictmeteringareaids/` | 获取所有DMA ID |
| GET | `/api/v1/getalldistrictmeteringareas/` | 获取所有DMA |
| GET | `/api/v1/getallregions/` | 获取所有区域 |
| GET | `/api/v1/getallserviceareas/` | 获取所有服务区 |
| GET | `/api/v1/getallvirtualdistrict/` | 获取所有虚拟分区 |
| GET | `/api/v1/getdistrictmeteringarea/` | 获取DMA信息 |
| GET | `/api/v1/getdistrictmeteringareaschema/` | 获取DMA属性架构 |
| GET | `/api/v1/getregion/` | 获取区域信息 |
| GET | `/api/v1/getregionschema/` | 获取区域属性架构 |
| GET | `/api/v1/getservicearea/` | 获取服务区信息 |
| GET | `/api/v1/getserviceareaschema/` | 获取服务区属性架构 |
| GET | `/api/v1/getvirtualdistrict/` | 获取虚拟分区信息 |
| GET | `/api/v1/getvirtualdistrictschema/` | 获取虚拟分区属性架构 |
| POST | `/api/v1/setdistrictmeteringarea/` | 设置DMA属性 |
| POST | `/api/v1/setregion/` | 设置区域属性 |
| POST | `/api/v1/setservicearea/` | 设置服务区属性 |
| POST | `/api/v1/setvirtualdistrict/` | 设置虚拟分区属性 |
### Action: `reservoirs`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addreservoir/` | 添加水库 |
| POST | `/api/v1/deletereservoir/` | 删除水库 |
| GET | `/api/v1/getallreservoirproperties/` | 获取所有水库属性 |
| GET | `/api/v1/getreservoircoord/` | 获取水库坐标 |
| GET | `/api/v1/getreservoirhead/` | 获取水库水头 |
| GET | `/api/v1/getreservoirpattern/` | 获取水库模式 |
| GET | `/api/v1/getreservoirproperties/` | 获取水库属性 |
| GET | `/api/v1/getreservoirschema` | 获取水库模式 |
| GET | `/api/v1/getreservoirx/` | 获取水库X坐标 |
| GET | `/api/v1/getreservoiry/` | 获取水库Y坐标 |
| POST | `/api/v1/setreservoircoord/` | 设置水库坐标 |
| POST | `/api/v1/setreservoirhead/` | 设置水库水头 |
| POST | `/api/v1/setreservoirpattern/` | 设置水库模式 |
| POST | `/api/v1/setreservoirproperties/` | 设置水库属性 |
| POST | `/api/v1/setreservoirx/` | 设置水库X坐标 |
| POST | `/api/v1/setreservoiry/` | 设置水库Y坐标 |
### Action: `tags`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/gettag/` | 获取标签信息 |
| GET | `/api/v1/gettags/` | 获取所有标签 |
| GET | `/api/v1/gettagschema/` | 获取标签属性架构 |
| POST | `/api/v1/settag/` | 设置标签 |
### Action: `tanks`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addtank/` | 新增水箱 |
| POST | `/api/v1/deletetank/` | 删除水箱 |
| GET | `/api/v1/getalltankproperties/` | 获取所有水箱属性 |
| GET | `/api/v1/gettankcoord/` | 获取水箱坐标 |
| GET | `/api/v1/gettankdiameter/` | 获取水箱直径 |
| GET | `/api/v1/gettankelevation/` | 获取水箱标高 |
| GET | `/api/v1/gettankinitlevel/` | 获取水箱初始水位 |
| GET | `/api/v1/gettankmaxlevel/` | 获取水箱最大水位 |
| GET | `/api/v1/gettankminlevel/` | 获取水箱最小水位 |
| GET | `/api/v1/gettankminvol/` | 获取水箱最小体积 |
| GET | `/api/v1/gettankoverflow/` | 获取水箱溢流口 |
| GET | `/api/v1/gettankproperties/` | 获取水箱属性 |
| GET | `/api/v1/gettankschema` | 获取水箱模式 |
| GET | `/api/v1/gettankvolcurve/` | 获取水箱容积曲线 |
| GET | `/api/v1/gettankx/` | 获取水箱X坐标 |
| GET | `/api/v1/gettanky/` | 获取水箱Y坐标 |
| POST | `/api/v1/settankcoord/` | 设置水箱坐标 |
| POST | `/api/v1/settankdiameter/` | 设置水箱直径 |
| POST | `/api/v1/settankelevation/` | 设置水箱标高 |
| POST | `/api/v1/settankinitlevel/` | 设置水箱初始水位 |
| POST | `/api/v1/settankmaxlevel/` | 设置水箱最大水位 |
| POST | `/api/v1/settankminlevel/` | 设置水箱最小水位 |
| POST | `/api/v1/settankminvol/` | 设置水箱最小体积 |
| POST | `/api/v1/settankoverflow/` | 设置水箱溢流口 |
| POST | `/api/v1/settankproperties/` | 设置水箱属性 |
| POST | `/api/v1/settankvolcurve/` | 设置水箱容积曲线 |
| POST | `/api/v1/settankx/` | 设置水箱X坐标 |
| POST | `/api/v1/settanky/` | 设置水箱Y坐标 |
### Action: `valves`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/addvalve/` | 添加阀门 |
| POST | `/api/v1/deletevalve/` | 删除阀门 |
| GET | `/api/v1/getallvalveproperties/` | 获取所有阀门属性 |
| GET | `/api/v1/getvalvediameter/` | 获取阀门直径 |
| GET | `/api/v1/getvalveminorloss/` | 获取阀门损失系数 |
| GET | `/api/v1/getvalvenode1/` | 获取阀门起点节点 |
| GET | `/api/v1/getvalvenode2/` | 获取阀门终点节点 |
| GET | `/api/v1/getvalveproperties/` | 获取阀门所有属性 |
| GET | `/api/v1/getvalveschema` | 获取阀门架构 |
| GET | `/api/v1/getvalvesetting/` | 获取阀门开度 |
| GET | `/api/v1/getvalvetype/` | 获取阀门类型 |
| POST | `/api/v1/setvalvenode1/` | 设置阀门起点节点 |
| POST | `/api/v1/setvalvenode2/` | 设置阀门终点节点 |
| POST | `/api/v1/setvalvenodediameter/` | 设置阀门直径 |
| POST | `/api/v1/setvalveproperties/` | 批量设置阀门属性 |
| POST | `/api/v1/setvalvesetting/` | 设置阀门开度 |
| POST | `/api/v1/setvalvetype/` | 设置阀门类型 |
## business/project-workspace
### Action: `extension`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getallextensiondata/` | 获取所有扩展数据 |
| GET | `/api/v1/getallextensiondatakeys/` | 获取所有扩展数据键 |
| GET | `/api/v1/getextensiondata/` | 获取指定扩展数据 |
| POST | `/api/v1/setextensiondata/` | 设置扩展数据 |
### Action: `misc`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getallburstlocateresults/` | 获取所有爆管定位结果 |
| GET | `/api/v1/getallsensorplacements/` | 获取所有传感器位置 |
| GET | `/api/v1/getjson/` | 获取JSON示例 |
| GET | `/api/v1/getrealtimedata/` | 获取实时数据 |
| GET | `/api/v1/getsimulationresult/` | 获取模拟结果 |
| POST | `/api/v1/test_dict/` | 测试字典处理 |
### Action: `project`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/closeproject/` | 关闭项目 |
| GET | `/api/v1/convertv3tov2/` | 转换 INP V3 为 V2 |
| GET | `/api/v1/convertv3tov2/` | 转换 INP V3 为 V2 |
| POST | `/api/v1/copyproject/` | 复制项目 |
| POST | `/api/v1/createproject/` | 创建新项目 |
| POST | `/api/v1/deleteproject/` | 删除项目 |
| GET | `/api/v1/downloadinp/` | 下载 INP 文件 |
| GET | `/api/v1/downloadinp/` | 下载 INP 文件 |
| GET | `/api/v1/dumpinp/` | 导出项目到 INP 文件 |
| GET | `/api/v1/dumpinp/` | 导出项目到 INP 文件 |
| GET | `/api/v1/exportinp/` | 导出项目为 ChangeSet |
| GET | `/api/v1/haveproject/` | 检查项目是否存在 |
| POST | `/api/v1/importinp/` | 导入 INP 文件内容 |
| GET | `/api/v1/isprojectlocked/` | 检查项目是否被锁定 |
| GET | `/api/v1/isprojectlocked/` | 检查项目是否被锁定 |
| GET | `/api/v1/isprojectlockedbyme/` | 检查项目是否被当前用户锁定 |
| GET | `/api/v1/isprojectlockedbyme/` | 检查项目是否被当前用户锁定 |
| GET | `/api/v1/isprojectopen/` | 检查项目是否已打开 |
| GET | `/api/v1/listprojects/` | 获取项目列表 |
| POST | `/api/v1/lockproject/` | 锁定项目 |
| POST | `/api/v1/lockproject/` | 锁定项目 |
| POST | `/api/v1/openproject/` | 打开项目 |
| GET | `/api/v1/project_info/` | 获取项目信息 |
| POST | `/api/v1/readinp/` | 读取 INP 文件到项目 |
| POST | `/api/v1/readinp/` | 读取 INP 文件到项目 |
| POST | `/api/v1/unlockproject/` | 解锁项目 |
| POST | `/api/v1/unlockproject/` | 解锁项目 |
| POST | `/api/v1/uploadinp/` | 上传 INP 文件 |
| POST | `/api/v1/uploadinp/` | 上传 INP 文件 |
### Action: `project_data`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/burst-locate-result` | 获取爆管定位结果 |
| GET | `/api/v1/burst-locate-result/{burst_incident}` | 按事件查询爆管定位结果 |
| GET | `/api/v1/scada-info` | 获取SCADA信息 |
| GET | `/api/v1/scheme-list` | 获取方案列表 |
### Action: `schemes`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/getallschemes/` | 获取所有方案 |
| GET | `/api/v1/getscheme/` | 获取单个方案 |
| GET | `/api/v1/getschemeschema/` | 获取方案模式 |
### Action: `snapshots`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/batch/` | 执行批量命令 |
| POST | `/api/v1/compressedbatch/` | 执行压缩批量命令 |
| GET | `/api/v1/getcurrentoperationid/` | 获取当前操作ID |
| GET | `/api/v1/getrestoreoperation/` | 获取恢复操作ID |
| GET | `/api/v1/getsnapshots/` | 获取快照列表 |
| GET | `/api/v1/havesnapshot/` | 检查快照是否存在 |
| GET | `/api/v1/havesnapshotforcurrentoperation/` | 检查当前操作快照是否存在 |
| GET | `/api/v1/havesnapshotforoperation/` | 检查操作快照是否存在 |
| POST | `/api/v1/pickoperation/` | 选择操作 |
| POST | `/api/v1/picksnapshot/` | 选择快照 |
| POST | `/api/v1/redo/` | 重做操作 |
| POST | `/api/v1/setrestoreoperation/` | 设置恢复操作ID |
| GET | `/api/v1/syncwithserver/` | 与服务器同步 |
| POST | `/api/v1/takenapshotforcurrentoperation` | 为当前操作创建快照(兼容模式) |
| POST | `/api/v1/takesnapshot/` | 创建快照 |
| POST | `/api/v1/takesnapshotforcurrentoperation` | 为当前操作创建快照 |
| POST | `/api/v1/takesnapshotforoperation/` | 为操作创建快照 |
| POST | `/api/v1/undo/` | 撤销操作 |
## data/timeseries-access
### Action: `composite`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/composite/clean-scada` | 清洗SCADA监测数据 |
| GET | `/api/v1/composite/element-scada` | 获取管网元素关联的SCADA监测数据 |
| GET | `/api/v1/composite/element-simulation` | 获取管网元素的模拟数据 |
| GET | `/api/v1/composite/pipeline-health-prediction` | 预测管道健康状况 |
| GET | `/api/v1/composite/scada-simulation` | 获取SCADA关联的模拟数据 |
### Action: `realtime`
| Method | Path | Summary |
|---|---|---|
| DELETE | `/api/v1/realtime/links` | 删除实时管道数据 |
| GET | `/api/v1/realtime/links` | 查询实时管道数据 |
| POST | `/api/v1/realtime/links/batch` | 批量插入实时管道数据 |
| PATCH | `/api/v1/realtime/links/{link_id}/field` | 更新实时管道字段 |
| DELETE | `/api/v1/realtime/nodes` | 删除实时节点数据 |
| GET | `/api/v1/realtime/nodes` | 查询实时节点数据 |
| POST | `/api/v1/realtime/nodes/batch` | 批量插入实时节点数据 |
| GET | `/api/v1/realtime/query/by-id-time` | 按ID和时间查询实时模拟数据 |
| GET | `/api/v1/realtime/query/by-time-property` | 按时间和属性查询实时数据 |
| POST | `/api/v1/realtime/simulation/store` | 存储实时模拟结果 |
### Action: `scheme`
| Method | Path | Summary |
|---|---|---|
| DELETE | `/api/v1/scheme/links` | 删除方案管道数据 |
| GET | `/api/v1/scheme/links` | 查询方案管道数据 |
| POST | `/api/v1/scheme/links/batch` | 批量插入方案管道数据 |
| GET | `/api/v1/scheme/links/{link_id}/field` | 查询方案管道字段数据 |
| PATCH | `/api/v1/scheme/links/{link_id}/field` | 更新方案管道字段 |
| DELETE | `/api/v1/scheme/nodes` | 删除方案节点数据 |
| POST | `/api/v1/scheme/nodes/batch` | 批量插入方案节点数据 |
| GET | `/api/v1/scheme/nodes/{node_id}/field` | 查询方案节点字段数据 |
| PATCH | `/api/v1/scheme/nodes/{node_id}/field` | 更新方案节点字段 |
| GET | `/api/v1/scheme/query/by-id-time` | 按ID和时间查询方案模拟数据 |
| GET | `/api/v1/scheme/query/by-scheme-time-property` | 按方案、时间和属性查询数据 |
| POST | `/api/v1/scheme/simulation/store` | 存储方案模拟结果 |
## platform/governance-observability
### Action: `audit`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/audit/logs` | 查询审计日志 |
| GET | `/api/v1/audit/logs/count` | 获取审计日志总数 |
| GET | `/api/v1/audit/logs/my` | 查询我的审计日志 |
### Action: `cache`
| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/clearallredis/` | 清除所有缓存 |
| POST | `/api/v1/clearrediskey/` | 清除单个缓存键 |
| POST | `/api/v1/clearrediskeys/` | 清除匹配的缓存键 |
| GET | `/api/v1/queryredis/` | 查询缓存键列表 |
### Action: `meta`
| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/meta/db/health` | 检查数据库健康状态 |
| GET | `/api/v1/meta/project` | 获取项目元数据 |
| GET | `/api/v1/meta/projects` | 列出用户项目 |