完成文件直传登记

演示环境

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

POST

/admin/v1/system/file/upload/complete

文件资源管理

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

完成单文件直传登记，将对象存储中的上传结果写入文件资源中心。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功

application/json

请求成功，返回统一响应数据。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://admin-api.wannanbigpig.com/admin/v1/admin/v1/system/file/upload/complete' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "bucket": "media-public",
    "complete_token": "complete_550e8400e29b41d4a716446655440000",
    "display_name": "本地 MinIO",
    "driver": "aliyun_oss",
    "etag": "\"9b2cf535f27731c974343645a3985328\"",
    "ext": ".png",
    "file_object_id": 101,
    "file_type": "image",
    "folder_id": 12,
    "hash": "sha256:2d711642b726b04401627ca9fbac32f5da7e5f0f8e9e6f4f8f6d8e9a0b1c2d3e",
    "is_public": 1,
    "mime_type": "image/png",
    "name": "MenuList",
    "object_key": "system/avatar/2026/04/23/avatar-admin.png",
    "origin_name": "avatar.png",
    "reuse": true,
    "size": 24567,
    "storage_driver": "local",
    "upload_scene": "system_file",
    "uuid": "6f9619ff8b86d011b42d00cf4fc964ff"
}'

响应示例

{
    "code": 0,
    "cost": "3.2ms",
    "data": {
        "bucket": "media-public",
        "created_at": "2026-04-23 15:00:00",
        "deleted_at": "2026-04-23 18:00:00",
        "deleted_by": 1,
        "deleted_reason": "用户主动删除",
        "display_name": "本地 MinIO",
        "etag": "\"9b2cf535f27731c974343645a3985328\"",
        "ext": ".png",
        "file_object_id": 101,
        "file_type": "image",
        "folder_id": 12,
        "hash": "sha256:2d711642b726b04401627ca9fbac32f5da7e5f0f8e9e6f4f8f6d8e9a0b1c2d3e",
        "id": 1,
        "is_public": 1,
        "last_accessed_at": "2026-04-23 15:30:00",
        "logical_path": "/系统文件/头像",
        "mime_type": "image/png",
        "name": "MenuList",
        "object_key": "system/avatar/2026/04/23/avatar-admin.png",
        "object_reuse_count": 3,
        "object_status": "stored",
        "object_status_name": "已存储",
        "origin_name": "avatar.png",
        "path": "/permission/menu",
        "reference_count": 3,
        "references": "system_config:site_logo",
        "size": 24567,
        "storage_base": "https://cdn.example.com",
        "storage_driver": "local",
        "storage_path": "/uploads/system",
        "storage_status": "stored",
        "storage_status_name": "已存储",
        "thumbnail_url": "https://cdn.example.com/thumbs/avatar-admin.png",
        "uid": 1,
        "updated_at": "2026-04-23 15:00:00",
        "upload_scene": "system_file",
        "upload_source": "backend",
        "upload_source_name": "本地上传",
        "upload_status": "uploaded",
        "upload_status_name": "已完成",
        "uploader_name": "超级管理员",
        "uploader_username": "super_admin",
        "url": "http://localhost:8080/admin/v1/file/6f9619ff8b86d011b42d00cf4fc964ff",
        "uuid": "6f9619ff8b86d011b42d00cf4fc964ff"
    },
    "msg": "success",
    "request_id": "req_20260423_0001"
}

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

更新文件资源

批量完成文件直传登记