生成文件副本

... 2026-2-4 大约 1 分钟

# 生成文件副本

# 接口说明

生成一个文件的副本。可以指定生成副本的文件名和所在文件夹。 注意 : 本接口不支持 pdf品类、文件夹、上传的本地文件。

# 请求格式

描述 定义
Path /openapi/drive/v3/files/{fileId}:copy
Method POST
Content-Type application/json; charset=utf-8

# 请求头部

详见Headers

# 请求参数

# 路径参数

参数名 类型 必选 描述
fileId string 文件 Id,文件的唯一标识

# 请求体

参数名 类型 必选 描述
name string 生成副本的文件名,默认和原文件一致
folderId string 新文件所在文件夹唯一标识,默认为用户文件夹根目录

# 请求示例

curl --location 'https://{domain}/openapi/drive/v3/files/DQVBVRUJXYkVWU2pp:copy' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--data '{
    "folderId":"",
    "name":"复制文档"
}'
1
2
3
4
5
6
7
1
2
3
4
5
6
7

# 响应参数

# 响应体

接口请求成功则会返回文件信息(FileInfo)。

# 响应示例

{
  "meta": {
    "id": "DQUpMUmlpQ2ltcGNk",
    "parentId": "AKTQTmGvOCyH",
    "name": "复制文档",
    "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
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

# 错误码

查询通用错误码

上次编辑于: 2026年2月4日 15:01
贡献者: daleshen