批量完成文件直传登记

演示环境

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

POST

/system/file/upload/complete/batch

文件资源管理

最后修改时间：2026-09-15 08:13:22

批量完成文件直传登记。服务端以每个条目的 complete_token 绑定的上传会话元数据为真相；客户端回传的 size、hash、bucket、object_key 等重复字段仅用于一致性校验，与签发凭证时的会话不一致将导致该条目失败。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

返回响应

🟢200成功

application/json

请求成功，按条目返回登记结果或失败原因。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://admin-api.wannanbigpig.com/admin/v1/system/file/upload/complete/batch' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: text/plain' \
--data ''

响应示例

{
    "code": 0,
    "cost": "3.2ms",
    "data": {
        "failed": 1,
        "items": [
            {
                "client_id": "pc-admin-1",
                "data": {
                    "bucket": "media-public",
                    "created_at": "2026-04-23 15:00:00",
                    "deleted_at": 0,
                    "deleted_by": 0,
                    "deleted_reason": "",
                    "display_name": "avatar.png",
                    "etag": "\"9b2cf535f27731c974343645a3985328\"",
                    "ext": ".png",
                    "file_object_id": 101,
                    "file_type": "image",
                    "folder_id": 12,
                    "hash": "2d711642b726b04401627ca9fbac32f5da7e5f0f8e9e6f4f8f6d8e9a0b1c2d3e",
                    "id": 1,
                    "is_public": 0,
                    "last_accessed_at": "2026-04-23 15:30:00",
                    "logical_path": "/系统文件/头像",
                    "mime_type": "image/png",
                    "name": "avatar-admin.png",
                    "object_key": "system/avatar/2026/04/23/avatar-admin.png",
                    "object_reuse_count": 0,
                    "object_status": "stored",
                    "object_status_name": "已存储",
                    "origin_name": "avatar.png",
                    "path": "system/avatar/2026/04/23/avatar-admin.png",
                    "reference_count": 0,
                    "references": [
                        {
                            "created_at": "string",
                            "field_name": "string",
                            "file_id": 0,
                            "id": 0,
                            "owner_field": "string",
                            "owner_id": 0,
                            "owner_type": "string",
                            "source_name": "string",
                            "updated_at": "string",
                            "uuid": "string"
                        }
                    ],
                    "size": 24567,
                    "storage_base": "media-public",
                    "storage_driver": "aliyun_oss",
                    "storage_path": "system/avatar/2026/04/23/avatar-admin.png",
                    "storage_status": "stored",
                    "storage_status_name": "已存储",
                    "thumbnail_url": "http://localhost:8080/admin/v1/file/6f9619ff8b86d011b42d00cf4fc964ff?variant=thumb",
                    "uid": 1,
                    "updated_at": "2026-04-23 15:00:00",
                    "upload_scene": "system_file",
                    "upload_source": "backend",
                    "upload_source_name": "前端直传",
                    "upload_status": "pending",
                    "upload_status_name": "已上传",
                    "uploader_name": "超级管理员",
                    "uploader_username": "super_admin",
                    "url": "http://localhost:8080/admin/v1/file/6f9619ff8b86d011b42d00cf4fc964ff",
                    "uuid": "6f9619ff8b86d011b42d00cf4fc964ff"
                },
                "error": {
                    "client_id": "pc-admin-2",
                    "code": 10000,
                    "index": 1,
                    "message": "complete_token is invalid",
                    "origin_name": "banner.png"
                },
                "success": true
            }
        ],
        "success": 1,
        "total": 2
    },
    "msg": "success",
    "request_id": "req_20260423_0001"
}

修改于 2026-09-15 08:13:22

完成文件直传登记

获取文件直传凭证