# 复制文件

将文件复制到用户云空间的其他文件夹中。不支持复制文件夹。

如果目标文件夹是我的空间，则复制的文件会在「我的空间」的「归我所有」列表里。
**注意事项**：为了更好地提升该接口的安全性，我们对其进行了升级，请尽快迁移至
  [新版本>>](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/copy)
该接口不支持并发创建，且调用频率上限为 5QPS 且 10000次/天

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/drive/explorer/v2/file/copy/files/:fileToken
HTTP Method | POST
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用**<br>开启任一权限即可 | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>查看、评论、编辑和管理文档(docs:doc)<br>查看、评论、编辑和管理电子表格(sheets:spreadsheet)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>或<br>`user_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

关于云文档接口的 AccessToken 调用说明详见 [云文档接口快速入门](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)
<br>

### 路径参数

名称 | 类型 | 描述
---|---|---
fileToken | string | 被复制文件的 token, 获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction)

### 请求体
|参数|类型|必须|说明|
|--|-----|--|----|
|type|string|是|被复制文件的类型   "file"、"doc"、"sheet"、"bitable"、"docx"、"mindnote" |||
|dstFolderToken|string|是|目标文件夹的 token, 获取方式见 [概述](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction) |||
|dstName|string|是|复制的副本文件的新名称 |||
|commentNeeded|bool|否|是否复制评论 |||

### 请求体示例
```json
{
  "type":"objType",
  "dstFolderToken":"string",
  "dstName":"string",
  "commentNeeded":true
}
```

## 响应
### 响应体
|参数|说明|
|--|--|
|folderToken|目标文件夹的 token|
|revision|新创建文件的版本号|
|token|新创建文件的 token|
|type|新创建文件的类型，"file"、"doc"、"sheet"、"bitable"、"docx"、"mindnote" |
|url|新创建文件的 url|

### 响应体示例
```json
{
    "code":0,
    "msg":"Success",
    "data":{
        "folderToken":"fldcne0HujIvzDmRF4Pbg0xxxxx",
        "revision":0,
        "token":"shtcnvJ358XqcZq87CCZHdxxxxx",
        "type":"sheet",
        "url":"https://example.feishu.cn/space/sheet/shtcnvJ358XqcZq87CCZHdxxxxx"
    }
}
```
### 错误码

错误码 | 说明 | 排查建议
---|---|---
91201 | FAILED | 处理失败，稍后重试。
91202 | PARAMERR | 参数错误，检查参数是否正确，如：`type`、`fileToken`、`dstFolderToken`。
91203 | NOTEXIST | 请检查请求参数是否正确，如：`type`跟`fileToken`是否匹配。
91204 | FORBIDDEN | 检查当前账户对文档、文件夹的权限。参考[接入流程授权](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/docs-overview#6d744fe3)
91205 | DELETED | 来源文件已被删除，检查是否还存在。
91206 | OUT_OF_LIMIT | 超过限制。
91207 | DUPLICATE | 重复记录。
91208 | REVIEW | 内容审查不通过。

具体可参考：[服务端错误码说明](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN)