更新文档（文件字节）

通过 multipart/form-data 上传已有文档的新版本。支持 docId、UUID 或两者联合定位；联合传入时必须对应。签名覆盖表单字段，fileSha256 用于文件完整性校验。

请求体

名称	类型	必填	描述	示例值
spaceId	int64	是	知识库空间 ID。	123456
docId	int64	否	文档 ID；与 uuid 至少传一个。	987654
uuid	string	否	客户文档 UUID；与 docId 同传时必须对应。	customer-doc-001
title	string	是	新文档标题。	产品手册-v2.pdf
classify	int32	否	文档分类，默认 1。	1
compressionType	string	是	文件类型，例如 doc、docx、pdf、xlsx、xls、md。	pdf
fileSha256	string	是	文件内容的 SHA-256 十六进制摘要。	a948904f2f0f479b8f8197694b30184b0d2ed1c1cd2a1ec0fb85d299a192a447
file	string	是

返回参数

名称	类型	描述	示例值
code	int32	业务响应码。200 表示成功；失败时为 RetCode 中定义的业务码。	200
msg	string	响应说明。成功通常为 ok；失败时为错误原因。	ok
message	string	兼容字段，部分异常场景可能返回错误说明。
data	object	导入或更新结果。docId=-1 时 errMsg 描述失败原因。
└docId	int64	导入或更新后的文档 ID；失败时可能为 -1。	987654
└uuid	string	客户文档 UUID。	customer-doc-001
└errMsg	string	导入或更新结果说明；成功为 success，失败为具体原因。	success

错误码

状态码	描述
400	请求参数错误。常见业务码：402 MISS_PARAM、403 ERR_PARAM。
401	OPENAPI_AUTH 鉴权失败。常见业务码：405 AUTH_FAILED。
404	资源不存在。常见业务码：404 NOT_FOUND、408 SPACE_NOT_EXISTS。
500	服务内部异常。常见业务码：500 ERROR。

postEndpoint

/api/athena/openApi/external/updateDocByFile

curl -X POST "https://b.163.com/api/athena/openApi/external/updateDocByFile" \  -F spaceId="123456" \  -F title="产品手册-v2.pdf" \  -F compressionType="pdf" \  -F fileSha256="a948904f2f0f479b8f8197694b30184b0d2ed1c1cd2a1ec0fb85d299a192a447" \  -F file="string"

{
  "code": 200,
  "msg": "ok",
  "message": "string",
  "data": {
    "docId": 987654,
    "uuid": "customer-doc-001",
    "errMsg": "success"
  }
}

{
  "code": 200,
  "msg": "ok",
  "message": "string"
}

{
  "code": 200,
  "msg": "ok",
  "message": "string"
}

{
  "code": 200,
  "msg": "ok",
  "message": "string"
}

{
  "code": 200,
  "msg": "ok",
  "message": "string"
}