上传文件

演示环境

https://admin-api.wannanbigpig.com/admin/v1

POST

/common/upload

通用与认证

最后修改时间：2026-07-03 08:40:35

通用文件上传接口，适用于不进入文件资源中心的简单上传场景。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数multipart/form-data必填

返回响应

🟢200成功

application/json

请求成功，返回 data.result 结果对象。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://admin-api.wannanbigpig.com/admin/v1/common/upload' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: Bearer <token>' \
--form 'files=@""' \
--form 'path="default"'

响应示例

{
    "code": 0,
    "cost": "3.2ms",
    "data": {
        "result": [
            {
                "ext": ".png",
                "failure_reason": "",
                "mime_type": "image/png",
                "name": "MenuList",
                "origin_name": "avatar.png",
                "path": "/permission/menu",
                "sha256": "2d711642b726b04401627ca9fbac32f5da7e5f0f8e9e6f4f8f6d8e9a0b1c2d3e",
                "size": 24567,
                "status": 1,
                "url": "http://localhost:8080/admin/v1/file/6f9619ff8b86d011b42d00cf4fc964ff",
                "uuid": "6f9619ff8b86d011b42d00cf4fc964ff"
            }
        ]
    },
    "msg": "success",
    "request_id": "req_20260423_0001"
}

修改于 2026-07-03 08:40:35

获取用户权限信息

检查 Token