文件管理

管理上传文件的接口。

获取文件列表

获取所有上传的文件。

接口信息

• 请求路径: GET /api/admin/files
• 认证方式: 需要认证（管理员权限）

查询参数

参数名	类型	必填	说明
page	number	否	页码，默认 1
limit	number	否	每页数量，默认 20
type	string	否	文件类型筛选：image/document/other

上传文件

上传单个或多个文件。

接口信息

• 请求路径: POST /api/admin/files/upload
• 认证方式: 需要认证（管理员权限）
• 内容类型: multipart/form-data

请求参数

参数名	类型	必填	说明
files	file	是	文件（支持多张）

请求示例

curl -X POST http://localhost:3000/api/admin/files/upload \
  -H "Authorization: Bearer your-jwt-token" \
  -F "files=@image1.jpg" \
  -F "files=@document.pdf"

响应示例

{
  "success": true,
  "data": [
    {
      "id": 1,
      "filename": "image1.jpg",
      "url": "https://example.com/uploads/image1.jpg",
      "size": 102400,
      "type": "image"
    }
  ]
}

删除文件

删除指定文件。

接口信息

• 请求路径: DELETE /api/admin/files/:id
• 认证方式: 需要认证（管理员权限）

错误响应

HTTP 状态码	说明
401	未登录或 Token 无效
403	权限不足（非管理员）
404	文件不存在
413	文件过大
500	服务器错误

文件限制

• 单文件最大 10MB
• 支持的图片格式：jpg, jpeg, png, gif, webp
• 支持的文档格式：pdf, doc, docx, xls, xlsx