复制文件

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

如果目标文件夹是我的空间，则复制的文件会在「我的空间」的「归我所有」列表里。

Error: 为了更好地提升该接口的安全性，我们对其进行了升级，请尽快迁移至 新版本>>

Note 该接口不支持并发创建，且调用频率上限为 5QPS 且 10000次/天

请求

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

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

Note 关于云文档接口的 AccessToken 调用说明详见 云文档接口快速入门

路径参数

名称	类型	描述
fileToken	string	被复制文件的 token, 获取方式见 概述

请求体

参数	类型	必须	说明
type	string	是	被复制文件的类型 "file"、"doc"、"sheet"、"bitable"、"docx"、"mindnote"
dstFolderToken	string	是	目标文件夹的 token, 获取方式见 概述
dstName	string	是	复制的副本文件的新名称
commentNeeded	bool	否	是否复制评论

请求体示例

{
  "type":"objType",
  "dstFolderToken":"string",
  "dstName":"string",
  "commentNeeded":true
}

响应

响应体

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

响应体示例

{
    "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	检查当前账户对文档、文件夹的权限。参考接入流程授权
91205	DELETED	来源文件已被删除，检查是否还存在。
91206	OUT_OF_LIMIT	超过限制。
91207	DUPLICATE	重复记录。
91208	REVIEW	内容审查不通过。

具体可参考：服务端错误码说明