完成分块上传

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

string

必填

你账户的 API 密钥。你可以在账户设置中找到它。

分块完成会将通过分块发送发送的分块组装成最终文件。分块列表在服务器上读取，因此你只需要发送 upload 令牌。一旦它返回响应，文件即已存储并计入你的配额。需要 blob:write scope，或开启该上传的上传令牌，以及有效计划。请求被拒绝时会发生什么取决于原因：

当账户没有有效计划（PERMISSION_DENIED）、超出配额（STORAGE_QUOTA_EXCEEDED）或存储不可用（503）时，上传会保持开启。解决问题后再次调用完成即可，无需重新发送任何分块。
当文件小于 512 字节（FILE_TOO_SMALL）或超过其限制（FILE_TOO_LARGE）时，上传会被中止，其分块会被丢弃。
当尚未发送任何分块（NO_CHUNKS_UPLOADED），或除最后一个外某个分块小于 5 MB（CHUNK_TOO_SMALL）时，什么都不会改变：重新发送该分块，然后再次完成。

参数

string

必填

分块初始化返回的 upload 令牌。也可以放在 upload 查询参数中。

速率限制

每 10 秒 5 次请求，因此多个并行上传可以同时完成（RATE_LIMITED，429）。

响应

string

成功为 “success”，否则为 “error”。

object

显示展开对象

string

已存储文件的 id。

boolean

文件是否为私有。

string | null

公开 URL，私有文件为 null。

ISO 8601

文件将被删除的时间。仅当文件会过期时出现。

number

文件大小，单位为字节。

number

组装的分块数量。

curl --request PATCH \
  --url 'https://blob.squarecloud.app/v1/objects/chunked' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "upload": "UPLOAD_TOKEN" }'

const response = await fetch('https://blob.squarecloud.app/v1/objects/chunked', {
  method: 'PATCH',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ upload: uploadToken }),
});

{
  "status": "success",
  "response": {
    "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
    "private": true,
    "url": null,
    "size": 2147483648,
    "parts": 128
  }
}

错误

代码	HTTP	触发情况
`INVALID_UPLOAD_TOKEN`	400	`upload` 令牌缺失、格式错误或不属于你。
`NO_CHUNKS_UPLOADED`	400	尚未发送任何分块。
`CHUNK_TOO_SMALL`	400	除最后一个外，某个分块小于 5 MB。
`FILE_TOO_SMALL`	400	文件小于 512 字节。上传被中止。
`PERMISSION_DENIED`	401	账户没有有效计划。上传保持开启。
`STORAGE_QUOTA_EXCEEDED`	403	该文件将超出内置存储配额。上传保持开启。
`UPLOAD_NOT_FOUND`	404	该上传已完成、已中止或已过期。
`FILE_TOO_LARGE`	413	文件超出其大小限制。上传被中止。
`RATE_LIMITED`	429	10 秒内超过 5 次请求。
`UPLOAD_FAILED`	500	组装失败。请重试。
`PRIVATE_STORAGE_UNAVAILABLE` / `PUBLIC_STORAGE_UNAVAILABLE`	503	存储暂时不可用。上传保持开启。

入门

对象

分块上传

账户

分享链接

S3

参数

速率限制

响应

错误

相关内容

​参数

​速率限制

​响应

​错误

​相关内容

参数

速率限制

响应

错误

相关内容