文件上传接口

--- 文件上传接口 ---
请求方式: POST (multipart/form-data)

请求参数:
file (File, 必填) 上传的文件，单文件

响应格式:
{
"code": 10000,
"message": "成功",
"data": {
"name": "example.jpg",
"size": 102400,
"size_display": "100.00 KB",
"type": "image/jpeg",
"ext": ".jpg",
"is_image": true,
"url": "/media/uploads/xxx.jpg",
"download_url": "/api/file/line1/download/uploads/xxx.jpg/",
"saved_name": "xxx.jpg"
}
}

错误码:
20001 参数缺失（未上传文件）
20003 参数值非法（文件类型不允许 / 文件大小超限）
50001 服务器内部错误（文件保存失败）

使用示例 (curl):
curl -X POST http://127.0.0.1:8000/api/file/line1/upload/
-F "file=@/path/to/example.jpg"

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "成功",
    "data": {
        "name": "屏幕截图 2026-05-26 215402.png",
        "size": 23770,
        "size_display": "23.21 KB",
        "type": "image/png",
        "ext": ".png",
        "is_image": true,
        "url": "/media/uploads/185a65a974d140b19864769d257643de.png",
        "download_url": "/api/file/line1/download/uploads/185a65a974d140b19864769d257643de.png/",
        "saved_name": "185a65a974d140b19864769d257643de.png"
    }
}

文件上传接口

请求参数

请求示例代码

返回响应