外观
登记已有对象 key：将我们桶中已存在的对象登记为正式 Version（不重搬字节）
POST
/v1/ingest/register-object
迁移工具 / 集成方已通过预签名直传或带外迁移把对象放进我们的桶后，调本端点仅登记成正式 Version。客户端声明目标（docId 已有文档 / containerId+title 新建文档，二选一）+ 已存在的对象 key；服务端校验对象 key 落在本租户命名空间前缀下、且对象在存储中真实存在（取实测大小，不信任客户端自报），随后复用上传 finalize 链路建立 Version（版本链 / ACL 继承 / 元数据 / 配额 / Webhook 与上传路径一致）。对象不属于本租户命名空间或不存在时拒绝，不创建空壳 Version。
授权
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", "objectKey": "string", "mimeType": "string", "originalFilename": "string", "expectedContentHash": "string", "metadata": "string", "comment": "string", "label": "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
{
}