ruoyi-ai/docs/文件上传接口文档.md

接口信息

接口路径: POST /resource/oss/upload 请求类型: multipart/form-data 权限要求: system:oss:upload 业务类型: [INSERT]

接口描述

上传OSS对象存储接口，用于将文件上传到对象存储服务。

请求参数

参数名	类型	必填	说明
file	MultipartFile	是	要上传的文件

请求头

• Content-Type: multipart/form-data

返回值

返回 R<SysOssUploadVo> 类型，包含以下字段：

字段名	类型	说明
url	String	文件访问URL
fileName	String	原始文件名
ossId	String	文件ID

响应示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "url": "fileid://xxx",
    "fileName": "example.jpg",
    "ossId": "123"
  }
}

异常情况

• 当上传文件为空时，返回错误信息："上传文件不能为空"