外观
初始化分片上传（含断点续传查询）
POST
/v1/versions/initChunkedUpload
声明一次分片上传会话：传入文件总大小、分片大小、分片总数与幂等键，返回 uploadId 与已上传分片索引（断点续传时据此跳过已传分片）。前置：对目标文档 / 容器具备上传权限。命中幂等键且会话已完成时直接返回 alreadyCompletedVersionId，不重复上传。
授权
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 "docId": "string", "containerId": "string", "title": "string", "documentTypeId": "string", "totalSize": 104857600, "chunkSize": 5242880, "totalChunks": 20, "idempotencyKey": "string", "expectedContentHash": "string", "mimeType": "string", "originalFilename": "string", "comment": "string", "label": "string", "metadata": "string"
{
}
响应
OK
*/*
JSON "code": 0, "data": { "uploadId": "string", "uploadedChunkIndexes": [ 0 ], "alreadyCompletedVersionId": "string" }, "ts": 0, "rid": "string", "msg": "string", "success": true
{
}