复制文件

POST

https://open.feishu.cn/open-apis/drive/v1/files/{file_token}/copy

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

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

该接口不支持并发拷贝多个文件，且调用频率上限为 5QPS 且 10000次/天

错误码

HTTP状态码	错误码	描述	排查建议
500	1061001	internal error.	服务内部错误，包括超时，错误码没处理。
400	1061002	params error.	请检查请求参数是否正确。
404	1061003	not found.	请确认对应资源是否存在。
403	1061004	forbidden.	请确认当前身份是否有对应上传节点的的权限，如用户是否有上传到指定doc的编辑权限。
401	1061005	auth failed.	请使用正确身份访问该接口。
404	1061007	file has been delete.	请确认对应节点未被删除。
400	1061045	can retry.	内部可重试错误，请稍后重试。
400	1062507	parent node out of sibling num.	云空间目录下挂载数量超过限制（单层1500限制）。
403	1064510	cross tenant and unit not support.	不支持跨租户跨地域的请求。
403	1064511	cross brand not support.	不支持跨品牌的请求。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/drive/v1/files//copy' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "name",
    "type": "file",
    "folder_token": "fldbcO1UuPz8VwnpPx5a92abcef"
}'

响应示例

{
    "code": 0,
    "data": {
        "file": {
            "name": "name",
            "parent_token": "fldcnBh8LrnX42dr1pBYclabcef",
            "token": "doxcnUkUOWtOelpFcha2Z9abcef",
            "type": "docx",
            "url": "https://bytedance.feishu.cn/docx/doxcnUkUOWtOelpFcha2Zabcef"
        }
    },
    "msg": "success"
}

请求参数

Path 参数

file_token

string

必需

被复制的文件token 示例值："doccngpahSdXrFPIBD4XdIabcef"

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

name

string

必需

被复制文件的新名称示例值："test.txt"

type

string

可选

被复制文件的类型，如果该值为空或者与文件实际类型不匹配，接口会返回失败。示例值："doc" 可选值有： file：文件类型 doc：文档类型 sheet：电子表格类型 bitable：多维表格类型 docx：新版文档类型 mindnote：思维笔记类型

folder_token

string

必需

文件被复制到的目标文件夹token 示例值："fldbcO1UuPz8VwnpPx5a92abcef"

extra

array [object {2}]

可选

用户自定义请求附加参数，用于实现特殊的复制语义

key

string

必需

自定义属性键对象示例值："target_type"

value

string

必需

自定义属性值对象示例值："docx"

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

data

object

必需

file

object

复制后的文件资源

必需

msg

string

错误描述

必需

修改于 2023-01-13 05:49:27

新建在线文档

移动文件

复制文件

错误码#

请求参数

返回响应

错误码