结构和功能的删除接口

This commit is contained in:
lxp
2026-07-08 18:29:51 +08:00
parent 82255a6feb
commit 43545aa715
6 changed files with 259 additions and 2 deletions
+74 -2
View File
@@ -386,7 +386,43 @@
`CadStructure`
### 4.5 CadStructure 响应字段
### 4.5 删除 CAD 结构
`DELETE /api/cad-models/{modelId}/structures/{structureId}`
按模型归属校验后逻辑删除结构。删除后该结构不会再出现在结构列表和结构详情中;后端会同步清理该结构关联的建模历史关系,以及功能中引用该结构的关系。
#### Path 参数
| 参数 | 类型 | 必填 | 约束 | 说明 |
| --- | --- | --- | --- | --- |
| `modelId` | number | 是 | 正整数 | 模型 ID |
| `structureId` | number | 是 | 正整数 | 结构 ID,必须归属当前模型且未逻辑删除 |
#### 请求体
无。
#### 响应 data
无。由于响应字段全局忽略 `null`,成功时通常不返回 `data` 字段。
```json
{
"code": "OK",
"message": "success",
"requestId": "b3f8..."
}
```
#### 失败说明
| HTTP 状态码 | code | 场景 |
| --- | --- | --- |
| 404 | `NOT_FOUND` | 模型不存在,或结构不存在、已删除、不是当前模型下的结构 |
| 422 | `INVALID_REQUEST` | `modelId``structureId` 不是正整数 |
### 4.6 CadStructure 响应字段
```json
{
@@ -547,7 +583,43 @@
`CadFunction`
### 5.5 CadFunction 响应字段
### 5.5 删除 CAD 功能
`DELETE /api/cad-models/{modelId}/functions/{functionId}`
按模型归属校验后逻辑删除功能。删除后该功能不会再出现在功能列表和功能详情中;后端会同步清理该功能下的结构关系。
#### Path 参数
| 参数 | 类型 | 必填 | 约束 | 说明 |
| --- | --- | --- | --- | --- |
| `modelId` | number | 是 | 正整数 | 模型 ID |
| `functionId` | number | 是 | 正整数 | 功能 ID,必须归属当前模型且未逻辑删除 |
#### 请求体
无。
#### 响应 data
无。由于响应字段全局忽略 `null`,成功时通常不返回 `data` 字段。
```json
{
"code": "OK",
"message": "success",
"requestId": "b3f8..."
}
```
#### 失败说明
| HTTP 状态码 | code | 场景 |
| --- | --- | --- |
| 404 | `NOT_FOUND` | 模型不存在,或功能不存在、已删除、不是当前模型下的功能 |
| 422 | `INVALID_REQUEST` | `modelId``functionId` 不是正整数 |
### 5.6 CadFunction 响应字段
```json
{