文件上传接口

文件上传相关接口。

单文件上传

上传单个文件。

请求

POST /api/v1/files
Content-Type: multipart/form-data

请求参数

参数	类型	必填	说明
file	file	是	文件
type	string	否	文件类型：avatar/image/document，默认 image

响应

{
  "code": "00000",
  "msg": "成功",
  "data": {
    "fileId": "uuid",
    "fileName": "image.png",
    "fileUrl": "https://oss.example.com/files/uuid.png",
    "fileSize": 102400
  }
}

---

多文件上传

批量上传多个文件。

请求

POST /api/v1/files/batch
Content-Type: multipart/form-data

请求参数

参数	类型	必填	说明
files	file[]	是	文件数组
type	string	否	文件类型

响应

{
  "code": "00000",
  "msg": "成功",
  "data": [
    {
      "fileId": "uuid1",
      "fileName": "image1.png",
      "fileUrl": "https://oss.example.com/files/uuid1.png",
      "fileSize": 102400
    },
    {
      "fileId": "uuid2",
      "fileName": "image2.png",
      "fileUrl": "https://oss.example.com/files/uuid2.png",
      "fileSize": 204800
    }
  ]
}

---

文件删除

删除已上传的文件。

请求

DELETE /api/v1/files/{fileId}

响应

{
  "code": "00000",
  "msg": "成功"
}

---

配置说明

文件上传相关配置：

配置项	说明	默认值
最大文件大小	单文件最大限制	10MB
允许的文件类型	允许上传的 MIME 类型	image/*, application/pdf
存储方式	本地/OSS/MinIO	本地
文件名策略	原始/UUID/时间戳	UUID