# 文件夹概述
本文档介绍云空间中文件夹相关能力的基础概念、文件夹 token 的获取方式和文件夹的 API 列表。

## 基础概念

文件夹是飞书云空间中用于管理文件和其它文件夹的容器。每个文件夹都有唯一的 token 作为标识。在不同接口中，其参数命名可能不同，包括 `token`、 `folder_token`、`folderToken` 等。

## 文件夹 token 获取方式

你可通过以下两种方式获取文件夹的 token：
- 如下图，在浏览器中打开文件夹，在地址栏中获取文件夹的 token。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/238e60969b143a519aa3b82c90a63fe6_pPLUwkpHdF.png?height=595&lazyload=true&maxWidth=728&width=1528)

- 调用开放平台接口获取：
    - 调用[获取我的空间（root folder）元数据](https://open.feishu.cn/document/ukTMukTMukTM/ugTNzUjL4UzM14CO1MTN/get-root-folder-meta)接口获取根目录（即根文件夹）的 token。
    - 继续调用[获取文件夹中的文件清单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/list)接口，获取根目录下文件夹的 token。

## 方法列表

以下为文件夹的方法列表。其中，“商店”代表应用商店应用；“自建”代表企业自建应用，了解更多应用相关信息，参考[应用类型简介](https://open.feishu.cn/document/home/app-types-introduction/overview)。了解调用服务端 API 的流程，参考[流程概述](https://open.feishu.cn/document/uMzNwEjLzcDMx4yM3ATM/ugzNwEjL4cDMx4CO3ATM)。

<b>方法 (API) | <b>权限要求（满足任一） | <b>访问凭证 | <b>商店 | <b>自建
---|---|---|---|---
[获取我的空间（root folder）元数据](https://open.feishu.cn/document/ukTMukTMukTM/ugTNzUjL4UzM14CO1MTN/get-root-folder-meta)`GET` /open-apis/drive/explorer/v2/root_folder/meta | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>查看云空间中文件元数据(drive:drive.metadata:readonly) | `tenant_access_token`<br>`user_access_token` | **✓** | **✓**
[获取文件夹中的文件清单](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/list)`GET` /open-apis/drive/v1/files | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>查看、评论和下载云空间中所有文件(drive:drive:readonly)<br>获取云空间文件夹下的云文档清单(space:document:retrieve) | `tenant_access_token`<br>`user_access_token` | **✓** | **✓**
[获取文件夹元数据](https://open.feishu.cn/document/ukTMukTMukTM/uAjNzUjLwYzM14CM2MTN)`GET` /open-apis/drive/explorer/v2/folder/:folderToken/meta | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>查看云空间中文件元数据(drive:drive.metadata:readonly) | `tenant_access_token`<br>`user_access_token` | **✓** | **✓**
[新建文件夹](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/create_folder)`POST` /open-apis/drive/v1/files/create_folder | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>创建云空间文件夹(space:folder:create) | `tenant_access_token`<br>`user_access_token` | **✓** | **✓**
[移动文件或文件夹](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/move)`POST` /open-apis/drive/v1/files/:file_token/move | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>移动云空间文件夹和云文档(space:document:move) | `tenant_access_token`<br>`user_access_token` | **✓** | **✓**
[删除文件或文件夹](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/delete)`DELETE` /open-apis/drive/v1/files/:file_token | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>删除云空间文件夹和云文档(space:document:delete) | `tenant_access_token`<br>`user_access_token` | **✓** | **✓**
[查询异步任务状态](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/task_check)`GET` /open-apis/drive/v1/files/task_check | 查看、评论、编辑和管理云空间中所有文件(drive:drive)<br>查看云空间中文件元数据(drive:drive.metadata:readonly)<br>查看、评论和下载云空间中所有文件(drive:drive:readonly) | `tenant_access_token`<br>`user_access_token` | **✓** | **✓**