:::tip 本章概要
API 接口速查表，按模块分组列出所有 RESTful 接口的请求方法、路径、说明和权限标识。
:::

<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->

# API 接口速查表

本章汇总项目所有 API 接口，按模块分类整理。所有接口统一挂在根路径下，前端通过 `/api` 前缀代理访问，需携带 `Authorization: Bearer <token>` 请求头（认证相关接口除外）。

## 认证管理（免登录）

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/captcha` | 获取图形验证码 | 无需登录 |
| POST | `/login` | 用户登录 | 无需登录 |

## 系统主页

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/index/getMenus` | 获取用户菜单 | 需登录 |
| GET | `/index/getUser` | 获取用户信息 | 需登录 |
| GET | `/index/getRouters` | 获取路由数据 | 需登录 |

## 文件上传

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| POST | `/upload/uploadFile` | 上传文件 | 需登录 |

## 用户管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/user/page` | 分页查询 | `sys:user:page` |
| GET | `/user/detail/{id}` | 详情查询 | `sys:user:detail` |
| GET | `/user/list` | 列表查询 | 需登录 |
| POST | `/user/add` | 新增用户 | `sys:user:add` |
| PUT | `/user/update` | 更新用户 | `sys:user:update` |
| DELETE | `/user/delete/{id}` | 删除用户 | `sys:user:delete` |
| PUT | `/user/status` | 设置状态 | `sys:user:status` |
| PUT | `/user/resetPwd` | 重置密码 | `sys:user:resetPwd` |

## 角色管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/role/page` | 分页查询 | `sys:role:page` |
| GET | `/role/detail/{id}` | 详情查询 | `sys:role:detail` |
| GET | `/role/list` | 列表查询 | 需登录 |
| POST | `/role/add` | 新增角色 | `sys:role:add` |
| PUT | `/role/update` | 更新角色 | `sys:role:update` |
| DELETE | `/role/delete/{id}` | 删除角色 | `sys:role:delete` |
| PUT | `/role/status` | 设置状态 | `sys:role:status` |

## 角色菜单权限

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/role/menu/index/{id}` | 获取角色菜单 | `sys:role:roleMenu` |
| POST | `/role/menu/save` | 分配菜单 | `sys:role:assignMenu` |

## 菜单管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/menu/list` | 菜单列表 | `sys:menu:list` |
| GET | `/menu/detail/{id}` | 详情查询 | `sys:menu:detail` |
| POST | `/menu/add` | 新增菜单 | `sys:menu:add` |
| PUT | `/menu/update` | 更新菜单 | `sys:menu:update` |
| DELETE | `/menu/delete/{id}` | 删除菜单 | `sys:menu:delete` |

## 部门管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/dept/list` | 部门列表 | `sys:dept:list` |
| GET | `/dept/detail/{id}` | 详情查询 | `sys:dept:detail` |
| POST | `/dept/add` | 新增部门 | `sys:dept:add` |
| PUT | `/dept/update` | 更新部门 | `sys:dept:update` |
| DELETE | `/dept/delete/{id}` | 删除部门 | `sys:dept:delete` |

## 岗位管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/position/page` | 分页查询 | `sys:position:page` |
| GET | `/position/detail/{id}` | 详情查询 | `sys:position:detail` |
| GET | `/position/list` | 列表查询 | 需登录 |
| POST | `/position/add` | 新增岗位 | `sys:position:add` |
| PUT | `/position/update` | 更新岗位 | `sys:position:update` |
| DELETE | `/position/delete/{id}` | 删除岗位 | `sys:position:delete` |
| PUT | `/position/status` | 设置状态 | `sys:position:status` |

## 职级管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/level/page` | 分页查询 | `sys:level:page` |
| GET | `/level/detail/{id}` | 详情查询 | `sys:level:detail` |
| GET | `/level/list` | 列表查询 | 需登录 |
| POST | `/level/add` | 新增职级 | `sys:level:add` |
| PUT | `/level/update` | 更新职级 | `sys:level:update` |
| DELETE | `/level/delete/{id}` | 删除职级 | `sys:level:delete` |
| PUT | `/level/status` | 设置状态 | `sys:level:status` |

## 城市管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/city/list` | 城市列表 | `sys:city:list` |
| GET | `/city/detail/{id}` | 详情查询 | `sys:city:detail` |
| POST | `/city/add` | 新增城市 | `sys:city:add` |
| PUT | `/city/update` | 更新城市 | `sys:city:update` |
| DELETE | `/city/delete/{id}` | 删除城市 | `sys:city:delete` |

## 文章管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/article/page` | 分页查询 | `sys:article:page` |
| GET | `/article/detail/{id}` | 详情查询 | `sys:article:detail` |
| POST | `/article/add` | 新增文章 | `sys:article:add` |
| PUT | `/article/update` | 更新文章 | `sys:article:update` |
| DELETE | `/article/delete/{id}` | 删除文章 | `sys:article:delete` |
| PUT | `/article/status` | 设置状态 | `sys:article:status` |

## 分类管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/category/list` | 分类列表 | `sys:category:list` |
| GET | `/category/detail/{id}` | 详情查询 | `sys:category:detail` |
| POST | `/category/add` | 新增分类 | `sys:category:add` |
| PUT | `/category/update` | 更新分类 | `sys:category:update` |
| DELETE | `/category/delete/{id}` | 删除分类 | `sys:category:delete` |

## 公告管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/notice/page` | 分页查询 | `sys:notice:page` |
| GET | `/notice/detail/{id}` | 详情查询 | `sys:notice:detail` |
| POST | `/notice/add` | 新增公告 | `sys:notice:add` |
| PUT | `/notice/update` | 更新公告 | `sys:notice:update` |
| DELETE | `/notice/delete/{id}` | 删除公告 | `sys:notice:delete` |

## 友链管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/link/page` | 分页查询 | `sys:link:page` |
| GET | `/link/detail/{id}` | 详情查询 | `sys:link:detail` |
| POST | `/link/add` | 新增友链 | `sys:link:add` |
| PUT | `/link/update` | 更新友链 | `sys:link:update` |
| DELETE | `/link/delete/{id}` | 删除友链 | `sys:link:delete` |
| PUT | `/link/status` | 设置状态 | `sys:link:status` |

## 参数管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/param/page` | 分页查询 | `sys:param:page` |
| GET | `/param/detail/{id}` | 详情查询 | `sys:param:detail` |
| POST | `/param/add` | 新增参数 | `sys:param:add` |
| PUT | `/param/update` | 更新参数 | `sys:param:update` |
| DELETE | `/param/delete/{id}` | 删除参数 | `sys:param:delete` |

## 字典管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/dict/page` | 字典分页查询 | `sys:dict:page` |
| GET | `/dict/detail/{id}` | 字典详情 | `sys:dict:detail` |
| POST | `/dict/add` | 新增字典 | `sys:dict:add` |
| PUT | `/dict/update` | 更新字典 | `sys:dict:update` |
| DELETE | `/dict/delete/{id}` | 删除字典 | `sys:dict:delete` |

## 字典项管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/dict/item/page` | 字典项分页 | `sys:dictItem:page` |
| GET | `/dict/item/detail/{id}` | 字典项详情 | `sys:dictItem:detail` |
| GET | `/dict/item/getDictItemList/{code}` | 按编码获取字典项 | 需登录 |
| POST | `/dict/item/add` | 新增字典项 | `sys:dictItem:add` |
| PUT | `/dict/item/update` | 更新字典项 | `sys:dictItem:update` |
| DELETE | `/dict/item/delete/{id}` | 删除字典项 | `sys:dictItem:delete` |

## 配置管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/config/page` | 配置分页查询 | `sys:config:page` |
| GET | `/config/detail/{id}` | 配置详情 | `sys:config:detail` |
| POST | `/config/add` | 新增配置 | `sys:config:add` |
| PUT | `/config/update` | 更新配置 | `sys:config:update` |
| DELETE | `/config/delete/{id}` | 删除配置 | `sys:config:delete` |

## 配置项管理

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/config/item/page` | 配置项分页 | `sys:configItem:page` |
| GET | `/config/item/detail/{id}` | 配置项详情 | `sys:configItem:detail` |
| POST | `/config/item/add` | 新增配置项 | `sys:configItem:add` |
| PUT | `/config/item/update` | 更新配置项 | `sys:configItem:update` |
| DELETE | `/config/item/delete/{id}` | 删除配置项 | `sys:configItem:delete` |
| PUT | `/config/item/status` | 设置状态 | `sys:configItem:status` |

## 网站配置

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/config/web/detail` | 获取网站配置 | 需登录 |
| PUT | `/config/web/update` | 更新网站配置 | `sys:configWeb:update` |

## 文件模板

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/file/template/page` | 分页查询 | `sys:fileTemplate:page` |
| GET | `/file/template/detail/{id}` | 详情查询 | `sys:fileTemplate:detail` |
| POST | `/file/template/add` | 新增模板 | `sys:fileTemplate:add` |
| PUT | `/file/template/update` | 更新模板 | `sys:fileTemplate:update` |
| DELETE | `/file/template/delete/{id}` | 删除模板 | `sys:fileTemplate:delete` |

## 定时任务

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/job/page` | 分页查询 | `sys:job:page` |
| GET | `/job/detail/{id}` | 详情查询 | `sys:job:detail` |
| POST | `/job/add` | 新增任务 | `sys:job:add` |
| PUT | `/job/update` | 更新任务 | `sys:job:update` |
| DELETE | `/job/delete/{id}` | 删除任务 | `sys:job:delete` |
| PUT | `/job/status` | 设置状态 | `sys:job:status` |

## 任务日志

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/job/log/page` | 任务日志分页 | `sys:jobLog:page` |

## 登录日志

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/login/log/page` | 登录日志分页 | `sys:loginLog:page` |

## 操作日志

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/oper/log/page` | 操作日志分页 | `sys:operationLog:page` |

## 案例管理（示例模块）

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/example/page` | 分页查询 | `sys:example:page` |
| GET | `/example/detail/{id}` | 详情查询 | `sys:example:detail` |
| GET | `/example/list` | 列表查询 | 需登录 |
| GET | `/example/data` | 下拉数据 | 需登录 |
| POST | `/example/add` | 新增案例 | `sys:example:add` |
| PUT | `/example/update` | 更新案例 | `sys:example:update` |
| DELETE | `/example/delete/{id}` | 删除案例 | `sys:example:delete` |
| PUT | `/example/status` | 设置状态 | `sys:example:status` |

## 代码生成器

| 方法 | 路径 | 说明 | 权限 |
|:----|:----|:----|:----|
| GET | `/generator/page` | 数据库表分页 | `sys:generator:page` |
| GET | `/generator/detail/{table_name}` | 表详情 | `sys:generator:detail` |
| POST | `/generator/generate` | 代码生成 | `sys:generator:generate` |

## 通用请求格式

### 分页查询参数

| 参数 | 类型 | 默认值 | 说明 |
|:----|:----|:----|:----|
| `pageNo` | int | 1 | 页码 |
| `pageSize` | int | 10 | 每页条数 |
| 其他字段 | - | - | 按模块定义的筛选字段传递 |

### 通用响应格式

```json
// 成功
{
    "code": 0,
    "msg": "操作成功",
    "data": {},
    "ok": true
}

// 分页响应
{
    "code": 0,
    "msg": "操作成功",
    "data": {
        "records": [],
        "total": 100,
        "size": 10,
        "current": 1,
        "pages": 10
    },
    "ok": true
}

// 失败
{
    "code": 1,
    "msg": "错误信息",
    "data": null,
    "ok": false
}
```

### 批量删除请求

批量删除通过 URL 参数传递逗号分隔的 ID：

```
DELETE /example/delete/1,2,3
```

## 总结

API 接口速查表汇总了系统所有 RESTful 接口，按模块分组列出请求方法、路径、说明和权限标识。接口路径直接挂在根路径下，前端通过 `/api` 前缀代理访问。权限标识遵循 `sys:{模块}:{操作}` 命名规范。