79 lines
1.8 KiB
Markdown
79 lines
1.8 KiB
Markdown
# API 文档：删除菜单接口
|
||
|
||
## 元数据
|
||
- **需求编号**：2026-01-21-002-03-30
|
||
- **创建时间**：2026-01-26
|
||
- **创建人**：SSOT 架构师
|
||
- **父需求**：2026-01-21-002-03-数据库国际化需求
|
||
|
||
## 接口概述
|
||
删除一条菜单。
|
||
|
||
## 接口详情
|
||
|
||
### 基本信息
|
||
- **接口名称**：删除菜单
|
||
- **接口描述**：删除菜单
|
||
- **请求方式**：DELETE
|
||
- **请求路径**：`/system/menu/{menuId}`
|
||
- **权限要求**：`system:menu:remove`
|
||
|
||
### 请求参数
|
||
| 参数名 | 类型 | 必选 | 说明 |
|
||
|--------|------|------|------|
|
||
| menuId | Long | 是 | 菜单ID（路径参数） |
|
||
|
||
### 请求示例
|
||
```bash
|
||
curl -X DELETE 'http://localhost:8080/system/menu/2' \
|
||
-H 'Authorization: Bearer {token}'
|
||
```
|
||
|
||
### 响应数据结构
|
||
| 参数名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| code | Integer | 状态码（200 成功，500 失败） |
|
||
| msg | String | 提示信息 |
|
||
| data | Object | 数据对象（通常为 null） |
|
||
|
||
### 响应示例
|
||
|
||
**成功响应：**
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": null
|
||
}
|
||
```
|
||
|
||
**失败响应：**
|
||
```json
|
||
{
|
||
"code": 500,
|
||
"msg": "存在子菜单,不允许删除",
|
||
"data": null
|
||
}
|
||
```
|
||
|
||
```json
|
||
{
|
||
"code": 500,
|
||
"msg": "菜单已分配,不允许删除",
|
||
"data": null
|
||
}
|
||
```
|
||
|
||
### 业务规则
|
||
1. 存在子菜单时不允许删除
|
||
2. 菜单已分配给角色时不允许删除
|
||
3. 删除成功后，清除菜单缓存
|
||
|
||
### 性能要求
|
||
- **响应时间**：< 100ms
|
||
- **数据库删除时间**：< 50ms
|
||
|
||
### 相关文档
|
||
- [需求文档](file:///d:/idea_demo/datai/datai-scenes/datai-scene-salesforce/docs/requirements/2026-01-21-002-03-数据库国际化需求.md)
|
||
- [设计文档](file:///d:/idea_demo/datai/datai-scenes/datai-scene-salesforce/docs/design/2026-01-21-002-03-数据库国际化设计.md)
|