结构和功能的删除接口
This commit is contained in:
@@ -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
|
||||
{
|
||||
|
||||
Reference in New Issue
Block a user