云空间概述

云空间是便捷管理知识资源的企业云盘。在飞书所有文档都集中存储在云端，支持多格式文件的高速上传、下载及预览，并通过电脑、手机随时随地查看、编辑、共享和协作，打造触手可及的知识智库。

资源	资源定义
文件夹	用于管理文件和其它文件夹的容器。
文件	各种类型的文件的统称，泛指云空间内所有的文件。

资源：文件夹 Folder

文件夹是用于管理文件和其它文件夹的容器。每个文件夹都有唯一 token 作为标识。

由于线上资源存在新老规范，文件夹 token 在部分接口中的命名可能为 folder_token, token, folderToken，在调用时请仔细阅读接口文档，避免因命名问题导致报错。

字段说明

名称	类型	描述
folder_token	string	一个文件夹的唯一标识。由于线上资源存在新老规范，文件夹 token 在部分接口中的命名可能为 folder_token, token, folderToken，在调用时请仔细阅读接口文档，避免因命名问题导致报错。示例值："fldcnK0sP9zb1TejQsaN0S54cHc"字段权限要求（任选其一）：查看、评论、编辑和管理云空间中所有文件查看、评论和下载云空间中所有文件
name	string	文件夹的名称。

方法列表

“商店”代表应用商店应用；“自建”代表企业自建应用

	方法 (API)	权限要求（满足任一）		访问凭证（选择其一）
新建文件夹`POST` /open-apis/drive/v1/files/create_folder	查看、评论、编辑和管理云空间中所有文件	tenant_access_tokenuser_access_token	✓	✓
获取空间根目录`GET` /open-apis/drive/explorer/v2/root_folder/meta获取云空间的根目录	查看、评论、编辑和管理云空间中所有文件	tenant_access_tokenuser_access_token	✓	✓
获取文件夹元信息`GET` /open-apis/drive/explorer/v2/folder/:folderToken/meta获取文件夹的元信息	查看、评论、编辑和管理云空间中所有文件	tenant_access_tokenuser_access_token	✓	✓
获取文件夹下的文档清单`GET` /open-apis/drive/v1/files	查看、评论、编辑和管理云空间中所有文件	tenant_access_tokenuser_access_token	✓	✓

资源：文件 Files

文件是各种类型的文件的统称，泛指云空间内所有的文件。每个文件都有唯一 token 作为标识。

字段说明

名称	类型	描述
file_token	string	一个文件的唯一标识。示例值："boxcnK7G8kasZRac70Wo50y6NGh"字段权限要求（任选其一）：查看、评论、编辑和管理云空间中所有文件查看、评论和下载云空间中所有文件
file_name	string	文件的名称。
parent_node	string	文件所在文件夹的 token。

方法列表

“商店”代表应用商店应用；“自建”代表企业自建应用

	方法 (API)	权限要求（满足任一）		访问凭证（选择其一）
上传文件`POST` /open-apis/drive/v1/files/upload_all用于上传 20M 以内的文件	查看、评论、编辑和管理云空间中所有文件上传、下载文件	tenant_access_tokenuser_access_token	✓	✓
分片上传文件`POST` /open-apis/drive/v1/files/upload_prepare `POST` /open-apis/drive/v1/files/upload_part `POST` /open-apis/drive/v1/files/upload_finish上传较大文件（>20M）时，推荐使用分片上传	查看、评论、编辑和管理云空间中所有文件上传、下载文件	tenant_access_tokenuser_access_token	✓	✓
下载文件`GET` /open-apis/drive/v1/files/:file_token/download	查看、评论、编辑和管理云空间中所有文件上传、下载文件	tenant_access_tokenuser_access_token	✓	✓
复制文件`POST` /open-apis/drive/v1/files/:file_token/copy	查看、评论、编辑和管理云空间中所有文件上传、下载文件	tenant_access_tokenuser_access_token	✓	✓
移动文件`POST` /open-apis/drive/v1/files/:file_token/move	查看、评论、编辑和管理云空间中所有文件上传、下载文件	tenant_access_tokenuser_access_token	✓	✓
删除文件`DELETE` /open-apis/drive/v1/files/:file_token	查看、评论、编辑和管理云空间中所有文件上传、下载文件	tenant_access_tokenuser_access_token	✓	✓
获取文件元数据`POST` /open-apis/drive/v1/metas/batch_query支持批量获取文件的元数据	查看、评论、编辑和管理云空间中所有文件上传、下载文件	tenant_access_tokenuser_access_token	✓	✓

资源：文件夹 Folder#

字段说明#

方法列表#

资源：文件 Files#

字段说明#

方法列表#

资源：文件夹 Folder

字段说明

方法列表

资源：文件 Files

字段说明

方法列表