新建文件
... 2026-2-4 大约 2 分钟
# 新建文件
# 接口说明
新建一个文件，包含在线文档、文件夹、共享空间。
# 请求格式
| 描述 | 定义 |
|---|---|
| Path | /openapi/drive/v3/files |
| Method | POST |
| Content-Type | application/json; charset=utf-8 |
# 请求头部
详见Headers。
# 请求参数
# 请求体
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| name | string | 是 | 文件名，即文件列表上的名称 |
| type | enum(FileType) | 是 | 文件类型，API 仅支持创建下列展示出的文件类型 |
| folderId | string | 否 | 新文件所在文件夹唯一标识，默认为用户文件夹根目录 |
| templateId | string | 否 | 模板id |
| hasChangeName | bool | 否 | 是否自行修改过name 若为true 文档正文将不会变更文件名 |
# 文件类型 FileType
| 字段 | 描述 |
|---|---|
| DOC | 在线文档 |
| SHEET | 在线幻灯片 |
| SLIDE | 在线表格 |
| FORM | 在线收集表 |
| FOLDER | 文件夹 |
| COLLABORATE | 共享空间 |
| SMART_CANVAS | 智能文档 |
| SMART_SHEET | 智能表格 |
| BOARD | 智能白板 |
# 请求示例
curl --location 'https://{domain}/openapi/drive/v3/files' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--data '{
"name":"V3测试表格",
"type":"SHEET",
"folderId":"",
}'
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 响应参数
# 响应体
接口请求成功则会返回文件信息(FileInfo)。
# 响应示例
{
"meta": {
"id": "DQUpMUmlpQ2ltcGNk",
"parentId": "AKTQTmGvOCyH",
"name": "V3测试表格",
"type": "SHEET",
"ext": "tencentsheet",
"status": "NORMAL",
"url": "https://{domain}/sheet/DQUpMUmlpQ2ltcGNk",
"icon": "https://{domain}/private_cdn/tim/docs/docs-design-resources/mobile/png@3x/file_sheet_64@3x-28f87b2076.png",
"creator": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"createTime": "1684846762855",
"owner": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"lastModifyingUser": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"modifiedTime": "1684846762855",
"accessTime": "1684846762858",
"isFolder": false,
"isLink": false
},
"entry": {
"sourceParentId": "",
"deleteTime": "0",
"isTop": false,
"topTime": "0",
"isStar": false,
"starTime": "0"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46