本文档主要介绍什么是云盘,云盘接口能力,以及如何接入云盘接口能力等。
为便于开发者接入,钉盘产品名称将于2022年2月14日更新为云盘,与钉钉产品名称保持一致。
什么是云盘
钉钉云盘是基于阿里云的企业盘,提供智能安全的企业数据管理方案。云盘是集文件存储、管理与多人协作于一体的文件管理平台。它支持在任何设备上随时随地一键存储、编辑、分享工作学习资料,文档协作更高效。
钉钉云盘由私人盘和企业盘组成,其中企业盘由三个文件夹组成:
- 我的文件、团队文件。
- 群文件。
- 其他微应用存储,可在OA后台“云盘-容量管理-微应用”查看。
私人盘初始容量为2GB,企业盘初始容量为100GB。更多功能介绍,请参见钉钉使用手册-云盘。
开放概览
云盘提供了丰富的接口开放能力,开发者通过API接口可以实现云盘和企业业务系统打通。
| API | API说明 | API版本 |
|---|
| 新建空间 | 新建企业共享空间。 | 新版 |
| 删除空间 | 删除企业共享空间。 | 新版 |
| 获取空间列表 | 获取空间详情信息。 | 新版 |
| 根据spaceId获取指定空间信息 | 根据spaceId获取指定空间的信息。 | 新版 |
名词解释
spaceId
钉盘以space作为文件存储容器,可类比电脑上的C盘、E盘等。例如在钉钉内,每一个群文件对应一个space,企业钉盘中的公共区、共享文件夹、我的文件等也分别对应一个space。
fileId
文件在钉盘内的唯一性标识。
自定义空间
针对企业或ISV的个性化需求,钉盘在企业下开辟了自定义空间来供企业或ISV使用。每个企业可以自定义若干存储空间,每个微应用可以使用一个自定义存储空间,该空间在钉钉客户端不可见,在电脑管理后台可以查看其占用企业空间的情况。
钉盘权限
区别于普通文件存储,钉盘提供完善的权限管理服务,文件的上传、下载、查看等操作需要在权限允许的条件下执行。
存储服务器 & 钉盘服务器
存储服务器提供文件的存储服务,存储服务器上以mediaId唯一标识文件。钉盘服务器提供文件的目录关系、权限管理等服务。钉盘系统以fileId唯一标识文件,存储服务器内文件可添加到钉盘文件系统。
企业空间容量
钉盘存储空间属于有限资源,超出部分需付费购买。钉盘为企业免费提供100G空间,微应用使用的自定义空间将占用企业空间。