ATKONBASE

外观

登记已有对象 key：将我们桶中已存在的对象登记为正式 Version（不重搬字节）​

POST
/v1/ingest/register-object

迁移工具 / 集成方已通过预签名直传或带外迁移把对象放进我们的桶后，调本端点仅登记成正式 Version。客户端声明目标（docId 已有文档 / containerId+title 新建文档，二选一）+ 已存在的对象 key；服务端校验对象 key 落在本租户命名空间前缀下、且对象在存储中真实存在（取实测大小，不信任客户端自报），随后复用上传 finalize 链路建立 Version（版本链 / ACL 继承 / 元数据 / 配额 / Webhook 与上传路径一致）。对象不属于本租户命名空间或不存在时拒绝，不创建空壳 Version。

参数​

请求头参数

Authorization*

访问令牌以 Bearer 方案在 HTTP Authorization 请求头携带。请在此填入完整值（含 Bearer 前缀），例如：Bearer <accessToken>。

类型
string
必填
示例"Bearer <accessToken>"
X-Atk-User-Token

强通道（可选）：以某已签发的 atkonbase 用户会话 token 调用，ACL 解析与操作归属走该用户。与弱通道 X-Atk-Act-As-Source(-Id) 互斥——同时携带返回业务码 101008。两个 SDK 均由 client 侧拦截器统一注入（actAsToken()），此处仅为门户演练暴露。

类型
string
X-Atk-Act-As-Source

弱通道（可选）：外部身份来源标识，须与 X-Atk-Act-As-Source-Id 成对携带，缺一返回业务码 101009。仅当该 Client 的 act_as_user_allowed=true 时生效，否则静默降级为 APP_ONLY；与强通道互斥。两个 SDK 均由 client 侧拦截器统一注入（actAsSource()），此处仅为门户演练暴露。

类型
string
X-Atk-Act-As-Source-Id

弱通道（可选）：外部身份在其来源系统内的 ID，须与 X-Atk-Act-As-Source 成对携带，缺一返回业务码 101009。

类型
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
}

试验场​

服务器
请求头
主体

示例​

技术支持 VitePress OpenAPI