创建上传会话

创建分块上传会话并获取每个分块的预签名 PUT URL

POST /openapi/memorylake/api/v1/drives/items/upload

创建分块上传会话。响应包含一个 upload_id，以及每个分块对应的一个预签名 PUT URL。随后您将每个分块直接上传到其 URL，保存返回的 ETag，最后调用创建条目并传入 item_type: "file" 和 from: { upload_id, part_etags }，在文件库中生成该文件。

此接口仅预留存储空间并返回 URL — 不会传输任何字节。在“创建条目”成功之前，文件在文件库中不可见。

所需权限： drive:item_add · service

流程说明： 这是文件库上传流程的第 1 步。第 2 步是创建条目（相同权限）。如需再将文件附加到项目中，请调用导入文档，该操作还额外需要 project:doc_add 权限。

请求体

file_size · integer · required

文件总大小（字节）。最小值为 1。服务器根据此值决定分块方案 — 分块数量以及每个分块的字节范围。

cURL

curl -X POST 'https://app.memorylake.cn/openapi/memorylake/api/v1/drives/items/upload' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "file_size": 10485760
  }'

响应

data · object

Show 上传会话

upload_id · string

上传令牌。创建文件条目时通过 from.upload_id 传回。

part_items · array

按顺序排列的待上传分块数组

Show 分块条目

number · integer

分块编号（从 1 开始）

size · integer

此分块需要 PUT 的字节数

upload_url · string

此分块的预签名 PUT URL

Success (200)

{
  "success": true,
  "data": {
    "upload_id": "upl-abc123def456",
    "part_items": [
      {
        "number": 1,
        "size": 5242880,
        "upload_url": "https://storage.example.com/upload?partNumber=1&uploadId=upl-abc123def456"
      },
      {
        "number": 2,
        "size": 5242880,
        "upload_url": "https://storage.example.com/upload?partNumber=2&uploadId=upl-abc123def456"
      }
    ]
  }
}

上传分块

此调用返回后，将每个分块 PUT 到其 upload_url。每次 PUT 的响应都包含一个 ETag 头 — 您必须按顺序收集全部 ETag 才能完成上传。

# Read part 1's bytes and PUT them
curl -X PUT 'https://storage.example.com/upload?partNumber=1&uploadId=upl-abc123def456' \
  --data-binary @part1.bin -D -
# → ETag: "d41d8cd98f00b204e9800998ecf8427e"

向 upload_url 发起 PUT 请求时不要发送 Authorization 头 — 该 URL 已经是预签名的。发送 Bearer 认证可能导致存储后端拒绝该 PUT 请求。

预签名 URL 会过期。创建上传会话后，请尽快完成所有分块上传并调用“创建条目”。如果在收尾前 URL 已过期，只需创建一个新的上传会话并重新开始。

下一步

创建条目

创建一个引用本次上传的 upload_id 和已收集 part_etags 的 file 条目，完成上传收尾。