> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ikhtisar

> Pahami konsep penyimpanan DingTalk, ikhtisar kemampuan open API, titik masuk tutorial, dan referensi sumber daya untuk mengelola file organisasi Anda.

Topik ini menjelaskan apa itu penyimpanan, kemampuan Storage API, dan sumber daya terkait.

## Apa itu penyimpanan

Storage API menyediakan solusi manajemen data yang cerdas dan aman untuk organisasi serta memenuhi kebutuhan skenario kolaborasi kantor yang berpusat pada penyimpanan file. Kemampuan intinya mencakup, tetapi tidak terbatas pada, unggah, unduh, kelola, dan transfer file, pratinjau serta pengeditan online untuk format file utama, dan manajemen izin. Anda dapat menggunakan Storage API untuk membangun apa saja, dari lampiran aplikasi sederhana hingga produk cloud drive berfitur lengkap.

Setelah aplikasi Anda mengintegrasikan Storage API, Anda dapat:

* Mentransfer file secara efisien antara aplikasi Anda dan aplikasi DingTalk lainnya.
* Memenuhi kebutuhan tata kelola file para Admin Organisasi. Untuk informasi selengkapnya, lihat [Konsol admin DingTalk](https://oa.dingtalk.io/dingtalk-enterprise-storage.htm#/).

## Ikhtisar kemampuan terbuka

Penyimpanan menyediakan serangkaian kemampuan open API yang kaya. Developer dapat mengintegrasikan penyimpanan dengan sistem bisnis organisasi mereka melalui panggilan API.

### Manajemen organisasi

| **API**                                                                                               | **Deskripsi**                                        | **Versi API** |
| ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ------------- |
| [Memperoleh informasi organisasi](/id/open/development/obtain-enterprise-storage-related-information) | Memperoleh informasi tentang penyimpanan organisasi. | Baru          |

### Aplikasi

| **API**                                                                                                                          | **Deskripsi**                                                 | **Versi API** |
| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ------------- |
| [Memperoleh informasi ruang penyimpanan grup](/id/open/development/obtain-group-storage-space-information)                       | Memperoleh informasi tentang ruang penyimpanan grup.          | Baru          |
| [Mengirim file penyimpanan ke pengguna tertentu sebagai aplikasi](/id/open/development/sends-a-storage-file-to-a-specified-user) | Mengirim file ke pengguna tertentu dengan identitas aplikasi. | Baru          |
| [Mengirim file ke obrolan tertentu](/id/open/development/send-file-to-specified-session)                                         | Mengirim file ke obrolan tertentu.                            | Baru          |
| [Mengirim tautan file ke obrolan tertentu](/id/open/development/send-a-file-link-to-the-specified-session)                       | Mengirim tautan file ke obrolan tertentu.                     | Baru          |
| [Memperoleh informasi aplikasi](/id/open/development/obtains-the-information-about-the-current-application)                      | Memperoleh informasi tentang aplikasi saat ini.               | Baru          |

### Manajemen ruang

| **API**                                                                  | **Deskripsi**                                           | **Versi API** |
| ------------------------------------------------------------------------ | ------------------------------------------------------- | ------------- |
| [Menambah ruang](/id/open/development/add-space)                         | Menambahkan ruang baru di dalam penyimpanan organisasi. | Baru          |
| [Memperoleh informasi ruang](/id/open/development/get-space-information) | Memperoleh informasi tentang ruang penyimpanan.         | Baru          |

### Manajemen file

| **API**                                                                                                                           | **Deskripsi**                                                                    | **Versi API** |
| --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------- |
| [Menambah folder](/id/open/development/add-folder)                                                                                | Menambahkan folder di dalam ruang penyimpanan.                                   | Baru          |
| [Menyalin file atau folder](/id/open/development/copy-an-object)                                                                  | Menyalin file atau folder.                                                       | Baru          |
| [Menyalin file atau folder secara massal](/id/open/development/copy-files-or-folders-in-bulk)                                     | Menyalin file atau folder secara massal.                                         | Baru          |
| [Memindahkan file atau folder](/id/open/development/move-a-file-or-folder)                                                        | Memindahkan lokasi file atau folder.                                             | Baru          |
| [Memindahkan file atau folder secara massal](/id/open/development/bulk-move-files-or-folders)                                     | Memindahkan file atau folder secara massal.                                      | Baru          |
| [Mengganti nama file atau folder](/id/open/development/rename-a-file-or-folder)                                                   | Mengganti nama file atau folder.                                                 | Baru          |
| [Menghapus file atau folder](/id/open/development/delete-a-file-or-folder)                                                        | Menghapus file atau folder.                                                      | Baru          |
| [Menghapus file atau folder secara massal](/id/open/development/delete-files-or-folders-in-bulk)                                  | Menghapus file atau folder secara massal.                                        | Baru          |
| [Memulihkan versi file sebelumnya](/id/open/development/restore-previous-versions-of-files)                                       | Memulihkan versi file sebelumnya.                                                | Baru          |
| [Memperoleh daftar versi file](/id/open/development/obtains-a-list-of-file-versions)                                              | Memperoleh daftar versi sebuah file.                                             | Baru          |
| [Memperoleh informasi file atau folder](/id/open/development/obtain-file-or-folder-information)                                   | Memperoleh informasi tentang file atau folder.                                   | Baru          |
| [Memperoleh informasi file atau folder secara massal](/id/open/development/get-file-or-folder-information-in-bulk)                | Memperoleh informasi tentang file atau folder secara massal.                     | Baru          |
| [Memperoleh daftar file atau folder](/id/open/development/get-a-list-of-files-or-folders)                                         | Memperoleh daftar file atau folder di dalam sebuah ruang.                        | Baru          |
| [Memperoleh daftar semua file atau folder di bawah sebuah ruang](/id/open/development/get-a-list-of-all-files-or-folders-under-a) | Memperoleh daftar rata (flattened) semua file atau folder di bawah sebuah ruang. | Baru          |
| [Memperoleh informasi pratinjau atau pengeditan file](/id/open/development/obtains-the-object-preview-or-editing-information)     | Memperoleh tautan pratinjau atau pengeditan sebuah file.                         | Baru          |
| [Memperbarui atribut aplikasi file atau folder](/id/open/development/update-file-application-properties)                          | Memperbarui atribut aplikasi file atau folder.                                   | Baru          |
| [Menghapus atribut aplikasi file atau folder](/id/open/development/delete-file-app-attribute)                                     | Menghapus atribut aplikasi file atau folder.                                     | Baru          |
| [Memperoleh thumbnail file secara massal](/id/open/development/get-file-thumbnails-in-bulk)                                       | Memperoleh informasi thumbnail file secara massal.                               | Baru          |

### Transfer file

| **API**                                                                                                                      | **Deskripsi**                                                          | **Versi API** |
| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | ------------- |
| [Memperoleh informasi unggahan file](/id/open/development/obtain-file-upload-informations)                                   | Memperoleh informasi unggahan file.                                    | Baru          |
| [Mengirimkan file](/id/open/development/submittal-file)                                                                      | Mengirimkan file untuk menyelesaikan unggahan.                         | Baru          |
| [Menginisialisasi unggahan multipart](/id/open/development/initialize-a-multipart-upload-object)                             | Menginisialisasi unggahan multipart sebuah file.                       | Baru          |
| [Memperoleh informasi unggahan multipart](/id/open/development/obtains-the-information-about-multipart-uploads-of-an-object) | Memperoleh informasi unggahan untuk setiap bagian setelah file dibagi. | Baru          |
| [Memperoleh informasi unduhan file](/id/open/development/obtains-the-download-information-about-a-file)                      | Memperoleh informasi unduhan sebuah file di dalam ruang penyimpanan.   | Baru          |

### Manajemen izin

| **API**                                                                                | **Deskripsi**                                                                             | **Versi API** |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------- |
| [Menambah izin](/id/open/development/add-permissions-file)                             | Menambahkan izin ke sebuah ruang penyimpanan.                                             | Baru          |
| [Menghapus izin](/id/open/development/delete-permissions-file)                         | Menghapus izin dari sebuah ruang penyimpanan.                                             | Baru          |
| [Memodifikasi izin](/id/open/development/modify-permissions-file)                      | Memodifikasi izin sebuah ruang penyimpanan.                                               | Baru          |
| [Memperoleh daftar izin](/id/open/development/get-permission-list)                     | Memperoleh daftar izin sebuah ruang penyimpanan.                                          | Baru          |
| [Mengatur mode pewarisan izin](/id/open/development/set-permission-inheritance-mode)   | Mengatur mode pewarisan izin berdasarkan uuid file, unionId operator, dan mode pewarisan. | Baru          |
| [Memperoleh mode pewarisan izin](/id/open/development/get-permission-inheritance-mode) | Memperoleh mode pewarisan izin berdasarkan uuid file dan unionId operator.                | Baru          |

### Manajemen Tempat Sampah

| **API**                                                                                             | **Deskripsi**                                             | **Versi API** |
| --------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------- |
| [Memperoleh informasi Tempat Sampah](/id/open/development/obtain-information-about-the-recycle-bin) | Memperoleh informasi tentang Tempat Sampah.               | Baru          |
| [Memperoleh daftar item daur ulang](/id/open/development/gets-the-list-of-recycle-items)            | Memperoleh daftar item daur ulang di Tempat Sampah.       | Baru          |
| [Memperoleh informasi item daur ulang](/id/open/development/obtain-recycling-item-information)      | Memperoleh informasi tentang sebuah item daur ulang.      | Baru          |
| [Memulihkan item daur ulang](/id/open/development/restore-recycle-items)                            | Memulihkan sebuah item daur ulang.                        | Baru          |
| [Memulihkan item daur ulang secara massal](/id/open/development/batch-restore-recycled-items)       | Memulihkan item daur ulang secara massal.                 | Baru          |
| [Menghapus item daur ulang](/id/open/development/delete-recycle-item)                               | Menghapus sebuah item daur ulang dari Tempat Sampah.      | Baru          |
| [Menghapus item daur ulang secara massal](/id/open/development/batch-delete-recycle-items)          | Menghapus item daur ulang di Tempat Sampah secara massal. | Baru          |
| [Mengosongkan Tempat Sampah](/id/open/development/empty-the-recycle-bin)                            | Mengosongkan Tempat Sampah berdasarkan ID-nya.            | Baru          |

### Manajemen tugas

| **API**                                                                                                                     | **Deskripsi**                                               | **Versi API** |
| --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------- |
| [Memperoleh informasi tugas asinkron di penyimpanan](/id/open/development/get-the-asynchronous-task-information-in-storage) | Memperoleh informasi tentang tugas asinkron di penyimpanan. | Baru          |

### Langganan peristiwa

| **API**                                                                                                    | **Deskripsi**                                               | **Versi API** |
| ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------- |
| [Berlangganan peristiwa perubahan file](/id/open/development/subscribe-to-file-change-events)              | Berlangganan peristiwa perubahan file penyimpanan.          | Baru          |
| [Berhenti berlangganan peristiwa perubahan file](/id/open/development/unsubscribe-from-file-change-events) | Berhenti berlangganan peristiwa perubahan file penyimpanan. | Baru          |

## Tutorial

DingTalk menyediakan contoh alur integrasi untuk Storage API.

| **Tutorial**                                                                                                            | **Deskripsi**                                                     | **Audiens**              | **Unduhan demo**                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Mengunggah, mempratinjau, dan mengunduh file Drive](/id/open/development/dingpan-document)                             | Mengunggah, mengunduh, dan mempratinjau file Drive.               | Semua developer DingTalk | [file-demo.zip](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250807/zkuhco/file-demo.zip?spm=ding_open_doc.document.0.0.244b769bqOAIbj\&file=file-demo.zip) |
| [Mengunggah file lokal ke DingTalk Docs (Dokumen Saya)](/id/open/development/upload-files-dingtalk-documents-documents) | Mengunggah file lokal ke direktori Dokumen Saya di DingTalk Docs. | Semua developer DingTalk | [doc-demo.zip](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250704/bpihcw/doc-demo.zip?spm=ding_open_doc.document.0.0.244b769bqOAIbj\&file=doc-demo.zip)    |

## Referensi sumber daya

* Sumber daya **Space** mencakup atribut berikut:

  | Atribut    | Tipe             | Deskripsi                                                                                                                                                                                      |
  | ---------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | spaceId    | string           | ID ruang.                                                                                                                                                                                      |
  | spaceName  | string           | Nama ruang.                                                                                                                                                                                    |
  | spaceType  | string           | Tipe ruang.  - **USER**: ruang pengguna - **APP**: ruang aplikasi                                                                                                                              |
  | quota      | int64            | Total kapasitas ruang.  **Catatan**  Nilai -1 menunjukkan bahwa ruang tidak memiliki batasan kuota. Jika ruang memiliki atribut organisasi, kuota tidak boleh melebihi kuota ruang organisasi. |
  | usedQuota  | int64            | Kapasitas ruang yang telah digunakan.                                                                                                                                                          |
  | createTime | string (iso8601) | Waktu pembuatan.                                                                                                                                                                               |
  | modifyTime | string (iso8601) | Waktu modifikasi.                                                                                                                                                                              |
* Sumber daya **File dan folder** mencakup atribut berikut:

  | Atribut       | Tipe   | Deskripsi                                                                                                                                               |
  | ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | id            | string | ID file atau folder.                                                                                                                                    |
  | spaceId       | string | ID ruang.                                                                                                                                               |
  | path          | string | Jalur file atau folder di dalam ruang.                                                                                                                  |
  | status        | string | Status.  - **NORMAL**: normal - **DELETED**: dihapus - **EXPIRED**: kedaluwarsa                                                                         |
  | partitionType | string | Partisi penyimpanan.  - **PUBLIC\_OSS\_PARTITION**: partisi penyimpanan OSS cloud publik - **MINI\_OSS\_PARTITION**: partisi penyimpanan MiniOSS khusus |
  | parentId      | string | ID folder induk.                                                                                                                                        |
  | fileType      | string | Tipe file.  - **FILE**: file - **FOLDER**: folder                                                                                                       |
  | extension     | string | Ekstensi nama file.                                                                                                                                     |
* Sumber daya **Permission** mencakup atribut berikut:

  | Atribut  | Tipe   | Deskripsi                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | id       | string | ID pengguna izin.  - Jika parameter type adalah **ORG**, atur parameter ini ke **corpId** organisasi. - Jika parameter type adalah **DEPT**, atur parameter ini ke **deptId** departemen. Panggil API [Memperoleh daftar departemen](/id/open/development/user-management-acquires-the-list-departments) untuk memperoleh nilai dept\_id. - Jika parameter type adalah **TAG**, atur parameter ini ke **nama tag**. - Jika parameter type adalah **CONVERSATION**, atur parameter ini ke **openConversationId** obrolan, yang diperoleh melalui API buat obrolan grup atau API buat grup skenario. - Jika parameter type adalah **USER**, atur parameter ini ke **unionId** pengguna. Panggil API [Kueri detail pengguna](/id/open/development/query-user-details) untuk memperoleh nilai unionid. |
  | roleId   | string | ID peran izin.  - **OWNER**: pemilik - **MANAGER**: pengelola - **EDITOR**: editor - **DOWNLOADER**: pengunduh - **READER**: penampil                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | type     | string | Tipe pengguna izin:  - **ORG**: organisasi - **DEPT**: departemen - **TAG**: tag kustom - **CONVERSATION**: obrolan - **USER**: pengguna                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | duration | string | Periode validitas otorisasi, dalam detik. Nilai default-nya adalah -1, yang menunjukkan validitas permanen.  - Periode validitas otorisasi berlaku ketika tipe ruang izin yang diberikan adalah APP. - Periode validitas otorisasi tidak berlaku ketika tipe ruang izin yang diberikan adalah USER, dan secara default bersifat validitas permanen.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
