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

# Open API sisi server

> Ikhtisar kemampuan dan titik masuk Open API sisi server YiDA — panduan bagi developer untuk menyelesaikan integrasi sisi server melalui DingTalk Open Platform dan melakukan operasi baca/tulis data formulir di backend.

Selain Open API untuk panggilan sisi klien, platform YiDA juga menyediakan Open API yang mendukung panggilan sisi server. Untuk detailnya, lihat [dokumentasi DingTalk Open Platform](https://open.dingtalk.com/document/orgapp-server/yida-overview).

## Panduan Pengguna

Ikuti langkah-langkah berikut untuk menggunakan Open API sisi server YiDA:

<Tip>
  DingTalk Open Platform menyediakan beberapa jenis Aplikasi, dan cara penggunaan Open API sisi server berbeda-beda menurut jenis Aplikasi. Untuk detailnya, lihat [Pengenalan Jenis Aplikasi DingTalk](https://open.dingtalk.com/document/orgapp/untitled-document-1689231271995).
</Tip>

### Langkah 1: Buat Aplikasi DingTalk

* Untuk membuat Aplikasi internal, lihat [Ikhtisar Proses Pengembangan Aplikasi Internal](https://open.dingtalk.com/document/orgapp/overview-of-development-process).
* Untuk membuat Aplikasi perusahaan pihak ketiga, lihat [Ikhtisar Aplikasi Perusahaan Pihak Ketiga](https://open.dingtalk.com/document/isvapp/isv-cooperation-guide).

### Langkah 2: Tambah Izin Panggilan API

Setelah Aplikasi dibuat, hanya API masuk (sign-in) dan notifikasi pesan yang aktif secara default. Tambahkan Izin API yang diperlukan sesuai kebutuhan pengembangan Anda.

* Untuk Aplikasi internal, lihat [Tambah Izin Panggilan API](/id/open/development/add-api-permission).
* Untuk Aplikasi perusahaan pihak ketiga, lihat [Tambah Izin Panggilan API](https://open.dingtalk.com/document/isvapp-server/add-interface-call-permissions?#topic-2149187).

### Langkah 3: Dapatkan access\_token untuk Aplikasi

access\_token berfungsi sebagai kredensial identitas. Saat memanggil API, gunakan access\_token untuk mengautentikasi identitas pemanggil.

* Untuk Aplikasi internal, lihat [Dapatkan access token dari Aplikasi internal](https://open.dingtalk.com/document/orgapp-server/obtain-the-access_token-of-an-internal-app#topic-2056397).
* Untuk Aplikasi perusahaan pihak ketiga, lihat [Dapatkan access token dari perusahaan yang diotorisasi](https://open.dingtalk.com/document/isvapp-server/obtain-the-access_token-of-the-authorized-enterprise?#topic-2056409).

## Daftar API

### Alur kerja

| Deskripsi API                                                                                                | Aplikasi internal | Aplikasi perusahaan pihak ketiga | Aplikasi personal pihak ketiga | Izin                            |
| :----------------------------------------------------------------------------------------------------------- | :---------------- | :------------------------------- | :----------------------------- | :------------------------------ |
| [Mulai proses persetujuan YiDA](https://open.dingtalk.com/document/orgapp/api-startinstance-v2)              | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data alur kerja YiDA |
| [Hapus instans alur kerja](https://open.dingtalk.com/document/orgapp-server/delete-process-instance)         | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data alur kerja YiDA |
| [Hentikan instans alur kerja](https://open.dingtalk.com/document/orgapp-server/terminate-a-process-instance) | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data alur kerja YiDA |

### Formulir

| Deskripsi API                                                                                                                                                                                                           | Aplikasi internal | Aplikasi perusahaan pihak ketiga | Aplikasi personal pihak ketiga | Izin                          |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------- | :------------------------------- | :----------------------------- | :---------------------------- |
| [Kueri data instans formulir](https://open.dingtalk.com/document/orgapp/api-searchformdatas-v2)                                                                                                                         | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Simpan data formulir](https://open.dingtalk.com/document/orgapp/api-saveformdata-v2)                                                                                                                                   | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |
| [Perbarui data formulir](https://open.dingtalk.com/document/orgapp/api-updateformdata-v2)                                                                                                                               | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |
| [Kueri data formulir](https://open.dingtalk.com/document/orgapp/api-getformdatabyid-v2)                                                                                                                                 | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Dapatkan nilai komponen karyawan](https://open.dingtalk.com/document/orgapp/gets-the-value-of-the-employee-component)                                                                                                  | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Dapatkan daftar definisi komponen formulir](https://open.dingtalk.com/document/orgapp/get-a-list-of-form-component-definitions)                                                                                        | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Dapatkan data komponen subformulir](https://open.dingtalk.com/document/orgapp/obtain-child-table-component-data)                                                                                                       | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Hapus data formulir](https://open.dingtalk.com/document/orgapp/delete-form-data)                                                                                                                                       | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |
| [Dapatkan beberapa ID instans formulir](https://open.dingtalk.com/document/orgapp/api-searchformdataidlist-v2)                                                                                                          | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Dapatkan data instans formulir secara batch](https://open.dingtalk.com/document/orgapp/obtain-multiple-form-instance-data)                                                                                             | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Hapus instans formulir secara batch](https://open.dingtalk.com/document/orgapp/delete-multiple-form-instances)                                                                                                         | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Buat instans formulir secara batch](https://open.dingtalk.com/document/orgapp/create-multiple-form-instances)                                                                                                          | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Perbarui nilai komponen dalam instans formulir secara batch](https://open.dingtalk.com/document/orgapp/batch-update-of-component-values-in-form-instances)                                                             | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Buat atau perbarui instans formulir](https://open.dingtalk.com/document/orgapp/api-createorupdateformdata-v2)                                                                                                          | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Dapatkan data instans formulir dengan kondisi kueri lanjutan (termasuk data komponen subformulir)](https://open.dingtalk.com/document/orgapp/api-searchformdatasecondgeneration-v2)                                    | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data formulir YiDA  |
| [Dapatkan data instans formulir dengan kondisi kueri lanjutan (tanpa data komponen subformulir)](https://open.dingtalk.com/document/orgapp/obtain-form-instance-data-using-advanced-query-conditions-excluding-subform) | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |
| [Perbarui instans formulir secara batch menggunakan data instans formulir](https://open.dingtalk.com/document/orgapp/update-multiple-form-instances-with-the-form-instance-data)                                        | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |
| [Kueri catatan perubahan formulir](https://open.dingtalk.com/document/orgapp/change-records-of-query-forms)                                                                                                             | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |
| [Dapatkan struktur desain alur kerja](https://open.dingtalk.com/document/orgapp/api-getprocessdesign)                                                                                                                   | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |
| [Dapatkan daftar alias komponen](https://open.dingtalk.com/document/orgapp/api-getformcomponentaliaslist)                                                                                                               | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data formulir YiDA |

### Tugas

| Deskripsi API                                                                                                                                                    | Aplikasi internal | Aplikasi perusahaan pihak ketiga | Aplikasi personal pihak ketiga | Izin                            |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------- | :------------------------------- | :----------------------------- | :------------------------------ |
| [Dapatkan catatan persetujuan](https://open.dingtalk.com/document/orgapp/queries-an-approval-record)                                                             | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data alur kerja YiDA  |
| [Terima atau tolak tugas persetujuan YiDA](https://open.dingtalk.com/document/orgapp/execute-approval-tasks)                                                     | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis data alur kerja YiDA |
| [Dapatkan tugas yang dikirim oleh anggota dalam organisasi](https://open.dingtalk.com/document/orgapp/obtains-the-tasks-submitted-by-someone-in-an-organization) | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data alur kerja YiDA  |
| [Dapatkan tugas persetujuan yang telah selesai di organisasi](https://open.dingtalk.com/document/orgapp/obtains-the-completed-approval-tasks-in-an-organization) | Didukung          | Didukung                         | Tidak didukung                 | Izin baca tugas YiDA            |
| [Alihkan tugas](https://open.dingtalk.com/document/orgapp/transfer-tasks)                                                                                        | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis tugas YiDA           |
| [Kueri tugas alur kerja yang sedang berjalan (VPC)](https://open.dingtalk.com/document/orgapp/query-process-running-tasks-vpc)                                   | Didukung          | Didukung                         | Tidak didukung                 | Izin baca tugas YiDA            |
| [Dapatkan daftar tugas (cakupan organisasi)](https://open.dingtalk.com/document/orgapp/query-tasks-from-the-organization-dimension)                              | Didukung          | Didukung                         | Tidak didukung                 | Izin baca tugas YiDA            |
| [Dapatkan notifikasi yang dikirim ke Pengguna](https://open.dingtalk.com/document/orgapp/get-notifications-sent-to-users)                                        | Didukung          | Didukung                         | Tidak didukung                 | Izin baca tugas YiDA            |
| [Kueri daftar tugas item yang di-CC ke saya (cakupan Aplikasi)](https://open.dingtalk.com/document/orgapp/query-copied-my-task-list-application-dimension)       | Didukung          | Didukung                         | Tidak didukung                 | Izin baca tugas YiDA            |
| [Kirim komentar](https://open.dingtalk.com/document/orgapp/submit-comment)                                                                                       | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis komentar YiDA        |
| [Eksekusi tugas persetujuan YiDA secara batch](https://open.dingtalk.com/document/orgapp/batch-execution-should-take-the-lead-of-approval-tasks)                 | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis komentar YiDA        |
| [Kueri komentar pada instans formulir YiDA secara batch](https://open.dingtalk.com/document/orgapp/batch-query-of-comments-appropriate-for-form-instances)       | Didukung          | Didukung                         | Tidak didukung                 | Izin tulis komentar YiDA        |

### Lampiran

| Deskripsi API                                                                                                                                                      | Aplikasi internal | Aplikasi perusahaan pihak ketiga | Aplikasi personal pihak ketiga | Izin                           |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------- | :------------------------------- | :----------------------------- | :----------------------------- |
| [Dapatkan URL Login senyap sementara dari Lampiran YiDA](https://open.dingtalk.com/document/orgapp/obtain-the-temporary-free-access-address-of-yixian-accessories) | Didukung          | Didukung                         | Tidak didukung                 | Izin baca data alur kerja YiDA |
