> ## 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

> Kenali RESTful API dari DingTalk Docs OpenAPI untuk otomatisasi baca-tulis dokumen, CRUD block, dan operasi massal — cocok untuk pembuatan dokumen otomatis, sinkronisasi konten, dan penulisan cerdas.

DingTalk Docs OpenAPI menyediakan sekumpulan antarmuka RESTful yang memungkinkan developer mengoperasikan DingTalk Docs secara terprogram. Gunakan API ini untuk mengotomatiskan pembacaan dan penulisan dokumen, mengelola elemen block (buat, baca, perbarui, hapus), menjalankan operasi konten secara massal, dan lainnya. API ini cocok untuk skenario seperti pembuatan dokumen otomatis, sinkronisasi konten, dan penulisan cerdas.

## Apa itu DingTalk Docs

DingTalk Docs adalah paket perkantoran kolaboratif untuk perusahaan yang dikembangkan sendiri oleh DingTalk, bagian dari Alibaba Group. Paket ini mencakup alat penulisan online seperti dokumen, spreadsheet, dan mind map. Dalam penggunaan sehari-hari, Anda dapat mengedit dan melihat konten dokumen langsung dari komputer, ponsel, atau tablet tanpa perlu mengunduh apa pun. Semua perubahan tersimpan otomatis secara real-time.

DingTalk Docs juga terintegrasi secara mendalam dengan DingTalk, sehingga memungkinkan kolaborasi yang efisien dengan rekan kerja berdasarkan hubungan organisasi. Gunakan DingTalk Docs untuk skenario kerja sehari-hari seperti pengumpulan informasi, manajemen proyek, rapat, pelaporan bisnis, dan onboarding karyawan baru. Untuk detail selengkapnya, lihat [Panduan Pengguna DingTalk - DingTalk Docs](https://docs.dingtalk.io/i/p/Y7kmbokZp3pgGLq2/docs/od245kZmnOeW4D4L73YEWYbzxL6R0wMQ).

## Ikhtisar kemampuan terbuka

### Daftar API

DingTalk Docs menyediakan sekumpulan open API yang kaya, yang memungkinkan developer melakukan operasi dasar pada dokumen.

| **API**                                                                                    | **Deskripsi**                                                                                                                                                                   | **Versi** |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| [Menimpa dokumen (otorisasi pengguna)](/id/open/development/api-docupdatecontent)          | Menimpa seluruh konten dokumen dalam format Markdown.  **Catatan**  Metode ini memerlukan otorisasi pengguna sebelum dipanggil.                                                 | Baru      |
| [Menimpa dokumen (otorisasi App)](/id/open/development/api-doc-updatecontent)              | Menimpa seluruh konten dokumen dalam format Markdown.  **Catatan**  Metode ini dapat dipanggil setelah memperoleh access token menggunakan kredensial App appKey dan appSecret. | Baru      |
| [Mendapatkan informasi unggah sumber daya](/id/open/development/api-getresourceuploadinfo) | Mendapatkan URL unggah untuk sumber daya tertentu dalam dokumen.                                                                                                                | Baru      |
| [Menyisipkan konten](/id/open/development/api-insertcontent)                               | Menyisipkan sepenggal konten Markdown pada posisi tertentu dalam dokumen.                                                                                                       | Baru      |
| [Membuat kueri elemen block](/id/open/development/api-docblocksquery)                      | Membuat kueri elemen block tingkat pertama di bawah node root sebuah dokumen.                                                                                                   | Baru      |
| [Menyisipkan elemen block](/id/open/development/api-docinsertblocks)                       | Menyisipkan satu elemen block pada posisi tertentu dalam dokumen.                                                                                                               | Baru      |
| [Memperbarui elemen block](/id/open/development/api-docblocksmodify)                       | Memperbarui konten atau atribut elemen block mana pun dalam dokumen.                                                                                                            | Baru      |
| [Menghapus elemen block](/id/open/development/api-docdeleteblock)                          | Menghapus elemen block tertentu dalam dokumen.                                                                                                                                  | Baru      |
| [Menambahkan teks ke akhir paragraf](/id/open/development/api-docappendtext)               | Menambahkan sepenggal teks ke akhir paragraf tertentu.                                                                                                                          | Baru      |
| [Menambahkan elemen inline ke akhir paragraf](/id/open/development/api-docappendparagraph) | Menambahkan elemen inline ke akhir paragraf tertentu.                                                                                                                           | Baru      |

### Daftar peristiwa Callback

* Peristiwa tugas ekspor dokumen selesai

## Glosarium

Sebelum menggunakan DingTalk Docs OpenAPI, Anda perlu memahami konsep inti berikut:

### dentryUuid

Pengidentifikasi unik sebuah dokumen. Misalnya, pada `https://docs.dingtalk.io/i/nodes/Z90D4da-id`, `dentryUuid`-nya adalah `Z90D4da-id`.

### blockId

Pengidentifikasi unik sebuah elemen block. Dapatkan melalui API "Membuat kueri elemen block".

### operatorId

`unionId` dari operator, digunakan untuk mengidentifikasi pengguna yang melakukan operasi dan untuk memverifikasi izin.

### BlockElement

Elemen block adalah unit dasar yang menyusun konten dokumen, seperti paragraf, heading, block sorot, dan tabel.

### InlineElement

Elemen inline disematkan di dalam elemen block, seperti stiker, gambar, tautan, dan slot.