外观
从 URL 拉取摄入：服务端 fetch 外部 URL 落存储再建 Version
POST
/v1/ingest/from-url
客户端声明目标（docId 已有文档 / containerId+title 新建文档，二选一）+ 外部 URL，服务端拉取内容落对象存储后复用上传 finalize 链路建立 Version（版本链 / ACL 继承 / 元数据 / 配额 / Webhook 与上传路径一致）。服务端按 SSRF 基线封禁内网 / 回环 / 云元数据地址（含重定向逐跳校验）、限制大小上限与超时。小文件走同步路径返回 mode=sync_completed 携带结果 Version；大文件 / 大小未知走异步路径返回 mode=async_accepted 携带任务标识，完成后通过 document.updated Webhook 通知、失败靠任务状态查询感知。
授权
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", "url": "string", "declaredSizeBytes": 0, "mimeType": "string", "originalFilename": "string", "metadata": "string", "comment": "string", "label": "string"
{
}
响应
OK
*/*
JSON "code": 0, "data": { "mode": "string", "syncResult": { "docId": "string", "versionId": "string", "blobId": "string", "versionNo": 0, "contentHash": "string", "sizeBytes": 0, "mimeType": "string", "originalFilename": "string" }, "taskId": "string", "taskStatus": "string" }, "ts": 0, "rid": "string", "msg": "string", "success": true
{
}