This topic introduces DingTalk Drive, its API capabilities, and how to integrate with these APIs.
To streamline developer integration, the product name “DingPan” will be updated to DingTalk Drive on February 14, 2022, to stay consistent with the DingTalk product name.
What is DingTalk Drive
DingTalk Drive is an enterprise drive built on Alibaba Cloud that delivers intelligent and secure data management for organizations. It is an all-in-one file management platform that combines file storage, management, and multi-user collaboration. With DingTalk Drive, you can store, edit, and share work and study materials on any device, anytime and anywhere, making document collaboration more efficient.
DingTalk Drive consists of a personal drive and an enterprise drive. The enterprise drive contains three folders:
- My Files and Team Files.
- Group files.
- Storage for other micro apps, which you can view under DingTalk Drive > Capacity Management > Micro App in the OA console.
The personal drive provides 2 GB of initial capacity, and the enterprise drive provides 100 GB of initial capacity. For more features, see DingTalk User Guide - DingTalk Drive.
API overview
DingTalk Drive offers a rich set of open APIs that let developers integrate DingTalk Drive with their enterprise business systems.
| API | Description | Version |
|---|
| Create a space | Create an enterprise shared space. | New |
| Delete a space | Delete an enterprise shared space. | New |
| Query the space list | Get details about spaces. | New |
| Get a space by spaceId | Get details about a specific space by spaceId. | New |
Glossary
spaceId
DingTalk Drive uses a space as the container for file storage, similar to drives such as C: or E: on a computer. For example, in DingTalk, each set of group files corresponds to a space, and the public area, shared folders, and My Files in the enterprise drive each correspond to a separate space.
fileId
The unique identifier of a file in DingTalk Drive.
Custom space
To meet the personalized needs of organizations or ISVs, DingTalk Drive provides custom spaces within each organization. An organization can create multiple custom storage spaces, and each micro app can use one custom storage space. Custom spaces are not visible in the DingTalk Client-side, but you can view the organization storage they occupy in the admin console.
DingTalk Drive permissions
Unlike standard file storage, DingTalk Drive provides comprehensive permission management. Actions such as uploading, downloading, and viewing files can only be performed when permissions allow.
Storage server and DingTalk Drive server
The storage server provides file storage, where each file is uniquely identified by a mediaId. The DingTalk Drive server manages folder hierarchies, permissions, and other services, and uniquely identifies each file by a fileId. Files on the storage server can be added to the DingTalk Drive file system.
Enterprise space capacity
Storage capacity in DingTalk Drive is a limited resource. Additional capacity beyond the included quota requires a paid purchase. DingTalk Drive provides 100 GB of free storage to each organization, and any custom space used by micro apps counts against this enterprise quota. 
