外观
确认预签名直传：校验对象 + 建 Version（V1 两段式第二段）
POST
/v1/versions/finalize-upload
V1 两段式直传的第二段。客户端将字节 PUT 到对象存储完成后回调本端点，携带第一段返回的 uploadId。服务端校验该上传会话有效（属于直传会话、未过期、归属当前调用方、未终结），并确认对象已存在且大小与声明一致，随后在同一事务内建立 Version 并完成会话。校验失败时不建立 Version 并将会话置为终止态，未被采用的对象由服务端后台回收。fallback 模式下误调本端点会因会话类型不匹配被拒。幂等：对已完成的会话再次 finalize 直接返回原结果（与 /upload 同语义）。
授权
apiKey
类型
API Key (header: Authorization)
参数
请求头参数
X-Atk-User-Token
强通道：系统自签的不透明用户会话 token，用于 Client 代表用户调用。 与 X-Atk-Act-As-Source / X-Atk-Act-As-Source-Id 互斥，同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
X-Atk-Act-As-Source
弱通道：身份 source 主张（要求 Client 已开启 actAsAllowed）。 必须与 X-Atk-Act-As-Source-Id 成对携带，缺一服务端返回 400 INCOMPLETE_ACT_AS_HEADERS；与 X-Atk-User-Token 互斥，同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
X-Atk-Act-As-Source-Id
弱通道：身份 sourceId 主张（要求 Client 已开启 actAsAllowed）。 必须与 X-Atk-Act-As-Source 成对携带，缺一服务端返回 400 INCOMPLETE_ACT_AS_HEADERS；与 X-Atk-User-Token 互斥，同时携带服务端返回 400 INVALID_DELEGATION_HEADERS。
类型
string
请求体
application/json
JSON "uploadId": "string"
{
}
响应
OK
*/*
JSON "code": 0, "data": { "docId": "string", "versionId": "string", "blobId": "string", "versionNo": 0, "contentHash": "string", "sizeBytes": 0, "mimeType": "string", "originalFilename": "string" }, "ts": 0, "rid": "string", "msg": "string", "success": true
{
}