上传文件

演示环境

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 直接为文件信息数组，与提交的 files 顺序一致，包含成功与失败项（失败项 status=ERROR 且 failure_reason 非空）。部分失败时返回业务错误码（FILE_UPLOAD_PARTIAL_FAIL）且 data 仍返回结果数组；全部失败或服务端异常时 data 为空。

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": [
        {
            "sha256": "2d711642b726b04401627ca9fbac32f5da7e5f0f8e9e6f4f8f6d8e9a0b1c2d3e",
            "uuid": "6f9619ff8b86d011b42d00cf4fc964ff",
            "name": "6f9619ff8b86d011b42d00cf4fc964ff.png",
            "origin_name": "avatar.png",
            "size": 24567,
            "path": "default/6f9619ff8b86d011b42d00cf4fc964ff.png",
            "ext": ".png",
            "mime_type": "image/png",
            "url": "http://localhost:8080/admin/v1/file/6f9619ff8b86d011b42d00cf4fc964ff",
            "failure_reason": "",
            "status": "SUCCESS"
        }
    ],
    "msg": "success",
    "request_id": "req_20260423_0001"
}

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

获取用户权限信息

检查 Token