文件上传

管理端通用文件上传，单文件不超过 50MB，multipart 字段名为 file。

上传文件

接口地址

POST /admin/upload/file

接口说明

multipart/form-data，字段名固定为 file，单文件最大 50MB。 文件会写入当前默认存储渠道，并在 sys_upload_file 记录上传档案； 响应的 url 按当前默认存储配置动态生成。

接口参数说明

无请求参数。

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 0,
    "file_name": "",
    "hash_name": "",
    "size": 0,
    "mime_type": "image/png",
    "relative_path": "2026/09/23/8f14e45fceea167a5a36dedd4bea2543.png",
    "absolute_path": "",
    "url": "/files/2026/09/23/8f14e45fceea167a5a36dedd4bea2543.png"
  }
}

响应参数说明

响应字段	类型	说明
id	integer	上传记录ID
file_name	string	原始文件名
hash_name	string	哈希文件名
size	integer	文件大小（字节）
mime_type	string	MIME 类型
relative_path	string	文件相对路径（业务字段请保存该值）
absolute_path	string	上传时的完整访问地址快照
url	string	当前可访问地址（按默认存储渠道动态生成）