规则之树 · 社区平台开源解决方案 RuleApp · RuleApi · Sulo · RuleApiVisible
模块：文件上传模块 接口数：11 更新：2026-09-05 16:11

文件上传模块

文件上传控制器 提供本地和cos上传，之后的接口支持都加在这里

类路径：UploadController 前缀：/upload

1. full

接口路径：POST /upload/full

权限：需要登录（普通用户及以上）

接口说明：通用上传接口 除这个接口外，其它接口都是为了兼容旧版

请求参数：

参数名 类型 必填 默认值 说明
file MultipartFile（文件上传） 否 - 文件上传
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

2. cosUpload

接口路径：POST /upload/cosUpload

权限：需要登录（普通用户及以上）

接口说明：上传cos @return

请求参数：

参数名 类型 必填 默认值 说明
file MultipartFile（文件上传） 否 - 文件上传
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

3. localUpload

接口路径：POST /upload/localUpload

权限：需要登录（普通用户及以上）

接口说明：上传到本地

请求参数：

参数名 类型 必填 默认值 说明
file MultipartFile（文件上传） 否 - 文件上传
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

4. ossUpload

接口路径：POST /upload/ossUpload

权限：需要登录（普通用户及以上）

接口说明：上传到oss

请求参数：

参数名 类型 必填 默认值 说明
file MultipartFile（文件上传） 否 - 文件上传
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

5. qiniuUpload

接口路径：POST /upload/qiniuUpload

权限：需要登录（普通用户及以上）

接口说明：上传到七牛云

请求参数：

参数名 类型 必填 默认值 说明
file MultipartFile（文件上传） 否 - 文件上传
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

6. ftpUpload

接口路径：POST /upload/ftpUpload

权限：需要登录（普通用户及以上）

接口说明：上传到远程ftp

请求参数：

参数名 类型 必填 默认值 说明
file MultipartFile（文件上传） 否 - 文件上传
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

7. s3Upload

接口路径：POST /upload/s3Upload

权限：需要登录（普通用户及以上）

接口说明：上传到oss

请求参数：

参数名 类型 必填 默认值 说明
file MultipartFile（文件上传） 否 - 文件上传
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

8. fileList

接口路径：GET/POST /upload/fileList

权限：公开接口；但当系统配置 isLogin=1 时会强制要求登录

接口说明：文件列表

请求参数：

参数名 类型 必填 默认值 说明
searchParams String（JSON 字符串，需后端解析） 否 - JSON 字符串，需后端解析
searchKey String 否 -
page Integer 否 1
order String 否 created
limit Integer 否 15

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

9. fileDelete

接口路径：GET/POST /upload/fileDelete

权限：需要超级管理员权限

接口说明：删除文件记录（仅删除数据库记录，不删除物理文件）

请求参数：

参数名 类型 必填 默认值 说明
id Integer 否 -
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

10. uploadChunk

接口路径：POST /upload/chunk

权限：需要登录（普通用户及以上）

接口说明：将 MultipartFile 转换为 File @param file @return @throws IOException

请求参数：

参数名 类型 必填 默认值 说明
uploadId String 否 -
index Integer 否 -
total Integer 否 -
file MultipartFile（文件上传） 否 - 文件上传
上传 H5 否 -
chunk String 否 -
base64 小程序 否 -
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

11. mergeChunks

接口路径：POST /upload/merge

权限：需要登录（普通用户及以上）

接口说明：将 MultipartFile 转换为 File @param file @return @throws IOException

请求参数：

参数名 类型 必填 默认值 说明
uploadId String 否 -
filename String 否 -
total Integer 否 -
token String 否 -

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

上一模块系统监控模块