创建上传会话

创建文件上传会话，并按照响应中的会话信息上传文件。

上传步骤

传入目标 uri、文件大小 size 和存储策略 policy_id 创建会话。

按 chunk_size 切分文件；chunk_size 为 0 时按单文件上传。

返回 upload_urls 时，将分片上传到这些地址；未返回时，调用“上传文件分片”接口并传入 session_id 与从 0 开始的分片序号。

需要完成请求时使用 completeURL；上传须在 expires 指定的时间前完成。

用户取消上传或发生不可重试错误时，调用“删除上传会话”。

credential、upload_urls 与 completeURL 仅对当前上传会话有效，应直接使用接口返回值。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
    "uri": "cloudreve://my/Inspirations/archive%20(3).zip",
    "size": 65328441,
    "policy_id": "J7uV",
    "last_modified": 1749524701494,
    "mime_type": "application/zip"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200Success

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "session_id": "9897ebae-7b73-4169-aabc-6396f470e4bb",
        "upload_id": "",
        "chunk_size": 26214400,
        "expires": 1749620196,
        "storage_policy": {
            "id": "J7uV",
            "name": "Default storage policy",
            "type": "local",
            "max_size": 0
        },
        "uri": "cloudreve://my/Inspirations/archive%20(3).zip",
        "callback_secret": "CALLBACK_SECRET"
    },
    "msg": ""
}

上传步骤#

请求参数

请求示例代码

返回响应

上传步骤