预上传文件

GET /api/file/preUploadFile.do

预上传用于取得上传地址和一次性上传凭据，之后还需实际传输文件内容。请求使用 Authorization: Bearer <access_token>。

URL 参数

参数	类型	说明
`parent_id`	string	目标文件夹 ID。原文允许根目录上传时省略；企业目录操作建议显式指定有权限的目录
`name`	string	必填，文件名
`file_id`	string	上传已有文件的新版本时指定；新建文件时省略

以下为结构示例，地址和凭据均为占位值，不能直接使用。

{
  "upload_token": "<UPLOAD_TOKEN>",
  "url": "https://upload.example.com/<SERVER_RETURNED_PATH>",
  "success": true,
  "code": 0
}

字段	类型	说明
`url`	string	服务端动态返回的上传地址；原文规定只能使用一次、有效期一小时
`upload_token`	string	下一步上传时提交的凭据
`success`	boolean	本次预上传请求是否成功
`code`	integer	业务状态码

向返回的 url 发起 multipart/form-data POST，包含二进制字段 file 和字符串字段 upload_token。不要自行拼接上传路径，也不要将文件内容以 JSON 提交。由 HTTP 客户端生成 multipart boundary。

成功上传后的响应包含 fileId、version、fileName、fileSize、success 和 code。检查 HTTP 状态与业务结果后再认定完成；超时不等于未上传，重试前先核查已有文件。