PUT/v1/uploads/{upload_id}/parts/{n}
发送上传分段
upload_part
请求体是第 n 个分段的字节（application/octet-stream）。大小必须正好是 part_size，最后一个分段为剩余部分（size - (part_count - 1) × part_size）；其他大小或超出 1…part_count 的编号返回 400 uploads.part_invalid。再次发送同一分段会替换它，分段可以并行发送，顺序不限。响应包含该分段的 SHA-256，以及值相同的 ETag。在 complete 之后发送分段返回 409 uploads.state_conflict，上传过期后发送则返回 410 uploads.expired。在 1.62.0 中新增。
身份验证
在 Authorization 请求头中传入 API 密钥：Authorization: Bearer <密钥>。
路径参数
upload_idstring必填上传 ID（
upl_后跟 32 个十六进制字符）。length ≤ 64
ninteger必填分段编号，取值 1 到
part_count。≥ 1, ≤ 1000
请求体
application/octet-stream
响应
200已收到分段。
响应头
ETag上传分段的 ETag，即其内容的 SHA-256，带引号。
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
ninteger必填分段编号。
≥ 1
sizeinteger (int64)必填分段大小（字节）。
sha256string必填分段的 SHA-256。
etagstring必填分段的 ETag，即带引号的 SHA-256。
400请求无效：参数值或对象状态不允许执行该操作（`detail` 为消息）。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
401未发送凭据（既没有会话 Cookie，也没有 API 密钥），或未找到该密钥。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
403不允许执行该操作：角色权限不足、无权访问合集或卡片、请求在“View as”模式下执行，或组织已被暂停或删除（`detail` 为对象，包含 `code: org_suspended | org_deleted`）。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
404对象不存在或您无权访问。对于访问受限的对象，API 不会确认其是否存在。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
409对象状态不允许执行该操作，例如存在重复、正在索引，或作业已处理过。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
410对象曾经存在，但已不可用：链接已被使用或已过期，或文件已在保留期限结束时删除。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
429请求过多（`api.rate_limited`）、组织每分钟、每天或每月的配额已用完（`api.quota_exceeded`；`error.details` 中包含 `quota`、`limit` 和 `reset_at`）、已达到组织的限额，或回答服务繁忙（`answers.engine_busy`）。请等待 `Retry-After` 头中给出的时间。
响应头
Retry-After重试请求前需要等待的秒数。
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
503此请求所依赖的服务暂时不可用。请稍后重试。
响应头
RateLimit-Policy当前生效的限制，格式遵循 IETF 草案
draft-ietf-httpapi-ratelimit-headers：以逗号分隔的项"<name>";q=<quota>;w=<window in seconds>。key是 API 密钥的请求速率（配额即突发量，时间窗口是配额完全恢复所需的时间；会话为user，无凭据时为ip）；minute、day和month是组织按 UTC 计算的自然分钟、自然日和自然月的配额。RateLimitRateLimit-Policy中每项限制的剩余量："<name>";r=<remaining>;t=<seconds until reset>。X-RateLimit-LimitRateLimit-Policy中最严格一项（剩余请求数最少的一项）的限额。X-RateLimit-Remaining最严格限制下的剩余请求数。
X-RateLimit-Reset距最严格限制重置的秒数。
application/json
错误码
除所有请求通用的错误码外，此接口还可能在 error.code 中返回以下错误码。
速率限制
响应带有 RateLimit 和 RateLimit-Policy 头，以及旧版的 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 头。429 响应带有以秒为单位的 Retry-After：等待后重试。