云空间概述

本文档介绍云空间中资源的定义、接口使用限制和能力接入流程。

基础概念

云空间中包含的资源及其定义如下所示。飞书开放平台基于以下资源，开放了一系列接口。

云空间：用于管理所有云文档资源的容器。
文件夹：用于管理文件和其它文件夹的容器。详情参考文件夹概述。
文件：各种类型的文件的统称，泛指云空间内所有的文件。包括在云空间创建的在线文档、电子表格、多维表格、思维笔记、知识库中的文档等，也包括从本地环境上传的各类文件。详情参考文件概述。
素材：在文档、电子表格、多维表格等中用到的资源素材，如文档中的图片、视频或文件等。详情参考素材概述。
版本：基于文档、电子表格、多维表格等生成的新版本。详情参考版本概述。
事件：文件和文件夹内容发生变更时会触发各类事件。详情参考订阅云文档事件。
节点：在云空间中，节点是可以直接挂载在云空间中的资源的基本单元。节点可以是文件夹或文件。每一个节点代表一个具体的资源或容器。

云空间中各类资源的关系如下图所示：

使用限制

云空间中根目录或文件夹的单层节点上限为 1500 个。超过此限制时，接口将返回 1062507 错误码。可通过将文件新建到不同文件夹中解决。
云空间中所有层级的节点总和的上限为 40 万个。
以下云空间中涉及到修改节点状态或改变节点结构类接口不支持并发调用，且调用频率上限为 5 QPS，10000 次/天。否则会返回 1061045 错误码，可通过稍后重试解决。

类别	接口
`文件夹相关接口`	`<br>- 新建文件夹 - 移动或删除文件夹`
`文件相关接口`	`<br> - 新建文件 - 复制文件 - 移动文件或文件夹 - 删除文件或文件夹 - 创建文件快捷方式 - 上传文件 - 分片上传文件-预上传 - 分片上传文件-上传分片 - 分片上传文件-完成上传 - 下载文件`

接入流程

接入云空间 OpenAPI 的流程如下图所示。了解更多，参考云文档概述的 接入流程 一节。