获取一批文件的上传凭证

POST

/data/files/upload-credentials

为 1-20 个文件生成直传凭证与 file_key。返回的 upload 字段是统一指令：method=PUT 时直接 PUT 二进制到 url；method=POST 时构造 multipart 表单（form_fields + file_field）。

凭证 1h 过期。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "files": [
        {
            "file_name": "report.pdf",
            "file_size": 102400,
            "mime_type": "application/pdf"
        },
        {
            "file_name": "photo.jpg",
            "file_size": 204800
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.emoosearch.com/open-api/v1/data/files/upload-credentials' \
--header 'Emoo-User-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "files": [
        {
            "file_name": "report.pdf",
            "file_size": 102400,
            "mime_type": "application/pdf"
        },
        {
            "file_name": "photo.jpg",
            "file_size": 204800
        }
    ]
}'

返回响应

🟢200

application/json

成功（code=200）或业务错误（HTTP 仍 200）。可能错误码：

4015 invalid_params（参数缺失或格式不合法）

4035 file_too_large（单文件超过 100 MB）

4084 invalid_open_api_user_id

500 server_error（后端识别不了 storage provider，极少出现，联系管理员）

Bodyapplication/json

示例

successtoo_large

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "file_key": "fk_xxx1",
            "file_name": "report.pdf",
            "file_size": 102400,
            "mime_type": "application/pdf",
            "upload": {
                "method": "PUT",
                "url": "https://minio.example.com/fk_xxx1?signature=...",
                "headers": {},
                "form_fields": {},
                "file_field": null
            }
        }
    ]
}

🟠401

修改于 2026-07-19 05:37:31

列出 folder 直接 children

确认文件上传完成