---
title: 预上传文件
description: GET /api/file/preUploadFile.do：预上传文件 接口说明，包含路径、方法、参数和返回信息。
slug: api-get-api-file-preuploadfile-do
lang: zh
category: 文件 API
category_order: 8
order: 107
api_method: GET
api_path: /api/file/preUploadFile.do
api_label: 预上传文件
keywords:
  - API
  - 预上传文件
  - /api/file/preUploadFile.do
---

# 预上传文件

| 属性 | 值 |
| --- | --- |
| HTTP 方法 | `GET` |
| 接口路径 | `/api/file/preUploadFile.do` |
| 所属分类 | 文件 API |

## 接口说明

接口路径：`/api/file/preUploadFile.do`

HTTP 方法：`GET`


**HTTP 方法：** `GET`

#### URL 参数

参数名 Comment(说明)
parent_id 目标文件夹 id（必填）(在根目录下上传可忽略此项) string
name 文件名（必填） string
file_id 上传新版本时需要指定上传那个文件的新版本(上传新文件可忽略此项) string
#### 正确的返回结果如下

{"upload_token":"92808ecfc2ac4e0ebc0b912edac3be4a","url":"http://testdocument.babel.cc/api/file/uploadPdf.do","su
ccess":true,"code":0}
#### 返回字段说明

属性名 类型 说明
url string 该 url 仅能使用 1 次，且有效期为 1 小时
调用此 url 上传文件，成功后会返回 fileId， fileName、version 等
upload_token string 上传文件时作为 post 的参数

## 调用说明

- 调用前需完成 [获取 token](api-post-api-token-do.md) 或相应免登录认证，并在请求 Header 中携带 `Authorization: Bearer <access_token>`。
- 参数和返回字段如因部署版本存在差异，应以实际私有云 API 文档和联调结果为准。
- 所属分类：文件 API。