> ## 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. # Panduan OpenAPI Eksklusif > Perkenalan OpenAPI eksklusif Persetujuan OA DingTalk untuk pelanggan Smart OA: cocok untuk skenario Pusat Persetujuan yang dibangun sendiri oleh organisasi, serah terima proses, dan integrasi pusat proses. Dilengkapi langkah aktivasi, aturan penagihan, dan FAQ. ## 1. Ringkasan fitur Untuk memenuhi kebutuhan developer dalam membangun aplikasi yang dipersonalisasi, mulai 1 September 2024 Persetujuan OA DingTalk secara bertahap merilis sejumlah OpenAPI eksklusif bagi pelanggan Smart OA. OpenAPI eksklusif ini menyediakan kapabilitas yang lebih kaya, menjawab kebutuhan bisnis yang lebih personal, dan mendukung pengembangan Aplikasi internal untuk berbagai skenario. Kami menyarankan developer memanfaatkan OpenAPI secara lebih tepat dan efektif untuk membangun ekosistem terbuka DingTalk yang lebih sehat. ## 2. Skenario penggunaan DingTalk dapat menambah, mengubah, atau menghapus cakupan maupun fungsi spesifik dari API berikut karena penyesuaian peraturan atau kebijakan, kepatuhan terhadap instruksi regulator, atau untuk menjaga keamanan layanan DingTalk. Cakupan API yang benar-benar terbuka bagi pelanggan mengacu pada informasi yang dipublikasikan di DingTalk Open Platform pada saat itu. | Nama OpenAPI | Detail OpenAPI | Skenario penggunaan | | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | | Kueri daftar tugas yang belum diproses pengguna di Pusat Persetujuan | Panggil API ini untuk mengueri daftar tugas persetujuan yang belum diproses oleh pengguna tertentu dalam Organisasi Anda (termasuk tugas Persetujuan OA resmi dan tugas persetujuan dari sistem bisnis pihak ketiga yang disinkronkan ke DingTalk), untuk membantu organisasi membangun Pusat Persetujuan sendiri. | Pusat Persetujuan yang dibangun sendiri oleh organisasi | | Kueri daftar tugas yang sudah diproses pengguna di Pusat Persetujuan | Panggil API ini untuk mengueri daftar tugas persetujuan yang sudah diproses oleh pengguna tertentu dalam Organisasi Anda (termasuk tugas Persetujuan OA resmi dan tugas persetujuan dari sistem bisnis pihak ketiga yang disinkronkan ke DingTalk), untuk membantu organisasi membangun Pusat Persetujuan sendiri. | Pusat Persetujuan yang dibangun sendiri oleh organisasi | | Kueri daftar instans yang telah diajukan pengguna di Pusat Persetujuan | Panggil API ini untuk mengueri daftar instans persetujuan yang telah diajukan oleh pengguna tertentu dalam Organisasi Anda (termasuk instans Persetujuan OA resmi dan instans persetujuan dari sistem bisnis pihak ketiga yang disinkronkan ke DingTalk), untuk membantu organisasi membangun Pusat Persetujuan sendiri. | Pusat Persetujuan yang dibangun sendiri oleh organisasi | | Kueri daftar instans yang diterima pengguna di Pusat Persetujuan | Panggil API ini untuk mengueri daftar instans persetujuan yang telah diterima oleh pengguna tertentu dalam Organisasi Anda (termasuk instans Persetujuan OA resmi dan instans persetujuan dari sistem bisnis pihak ketiga yang disinkronkan ke DingTalk), untuk membantu organisasi membangun Pusat Persetujuan sendiri. | Pusat Persetujuan yang dibangun sendiri oleh organisasi | | Terima atau tolak tugas persetujuan secara massal | Panggil API ini menggunakan userId, result tugas, dan remark komentar yang ditentukan untuk memproses secara massal sekumpulan tugas persetujuan dengan ID instans dan ID node tugas yang berbeda. | Pusat Persetujuan yang dibangun sendiri oleh organisasi | | Admin mengueri daftar tugas yang belum diproses milik Karyawan tertentu | API ini menyediakan layanan kueri tugas yang belum diproses bagi admin organisasi. Melalui managerUserId, admin dapat mengueri semua informasi tugas Persetujuan OA yang belum diproses milik pemberi persetujuan (UserId) tertentu. API ini mendukung kueri tugas yang belum diproses baik untuk karyawan aktif maupun karyawan yang telah keluar. | Solusi serah terima proses | | Admin mengalihkan tugas yang belum diproses milik Karyawan tertentu secara massal | Berdasarkan API kueri tugas persetujuan yang akan dialihkan, admin dapat mengalihkan tugas secara massal ke karyawan aktif lain dalam organisasi. Pihak yang mengalihkan dapat berupa karyawan aktif atau karyawan yang telah keluar, sedangkan pihak penerima tugas alih harus berupa karyawan aktif dalam organisasi. | Solusi serah terima proses | | Buat atau perbarui Grup bisnis | Panggil API ini untuk menyinkronkan informasi Grup bisnis dari sistem pihak ketiga ke Persetujuan OA DingTalk, sekaligus membuat Grup Sumber bisnis tingkat kedua di bawah kategori Persetujuan OA pada Tugas DingTalk. Selanjutnya, saat menyinkronkan tugas yang belum diproses ke DingTalk, Anda dapat menentukan informasi Grup bisnis dari tugas tersebut. | Integrasi pusat proses (Grup bisnis Kustom) | | Hapus Grup bisnis | Panggil API ini untuk menghapus informasi Grup yang telah disinkronkan pihak ketiga ke Persetujuan OA DingTalk, sekaligus menghapus subkategori tingkat kedua di bawah kategori Persetujuan OA pada Tugas DingTalk. Data Tugas DingTalk pada kategori terkait akan dipindahkan ke Grup \[Lainnya] di bawah kategori Persetujuan OA. | Integrasi pusat proses (Grup bisnis Kustom) | | Simpan templat persetujuan integrasi eksternal pusat proses (mendukung featureConfig seperti hosting persetujuan dan Grup bisnis Kustom) | Panggil API ini untuk menyinkronkan data templat persetujuan milik sistem bisnis pihak ketiga ke Persetujuan OA DingTalk, sekaligus melakukan konfigurasi integrasi Kustom pada tingkat templat untuk berbagai modul fitur Premium seperti hosting persetujuan, Grup bisnis Kustom, dan persetujuan cepat Kustom. | Integrasi pusat proses (mode hosting Halaman persetujuan) | | Simpan instans persetujuan integrasi eksternal pusat proses (mendukung featureConfig seperti hosting persetujuan dan Grup bisnis Kustom) | Panggil API ini untuk menyinkronkan data instans persetujuan milik sistem bisnis pihak ketiga ke Persetujuan OA DingTalk, sekaligus melakukan konfigurasi integrasi Kustom pada tingkat instans untuk berbagai modul fitur Premium seperti hosting persetujuan, Grup bisnis Kustom, dan persetujuan cepat Kustom. | Integrasi pusat proses (mode hosting Halaman persetujuan) | | Simpan tugas persetujuan integrasi eksternal pusat proses (mendukung featureConfig seperti persetujuan cepat Kustom) | Panggil API ini agar sistem pihak ketiga dapat mengonfigurasi API Callback untuk tugas persetujuan. Dengan begitu, pemberi persetujuan dapat langsung melakukan Tindakan persetujuan di pusat tugas persetujuan DingTalk. Pusat tugas persetujuan akan mengirim Callback ke sistem pihak ketiga; sistem pihak ketiga memperbarui informasi tugas setelah menerima Callback, lalu menyinkronkan kembali informasi tugas terbaru ke Pusat Persetujuan sehingga membentuk siklus tertutup. | Integrasi pusat proses (Grup bisnis Kustom) | ### 1. Pusat Persetujuan yang dibangun sendiri oleh organisasi Pelanggan telah mengintegrasikan tugas persetujuan dari beberapa sistem bisnis (dikembangkan sendiri atau sistem pihak ketiga yang dibeli) ke Pusat Persetujuan DingTalk, dan ingin memanfaatkan kapabilitas terbuka Persetujuan OA DingTalk untuk membangun Pusat Persetujuan sendiri guna mengaktifkan fitur seperti Filter berdasarkan Sumber dan persetujuan massal: ![Contoh praktik Pusat Persetujuan yang dibangun sendiri, daftar tugas persetujuan mendukung Filter berdasarkan Sumber dan persetujuan massal](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/93e3ab21-51da-45f4-8365-a5484cb5e1de.png) ### 2. Solusi serah terima proses Pelanggan ingin memanfaatkan kapabilitas terbuka Persetujuan OA DingTalk untuk menyediakan fitur serah terima proses Persetujuan OA resmi DingTalk di dalam sistem bisnis organisasi, sehingga Admin dapat mengalihkan tugas persetujuan secara massal kepada Pengguna lain dalam organisasi. Admin mengueri daftar tugas yang belum diproses milik Karyawan tertentu: ![Contoh praktik serah terima proses, Admin Console mengueri daftar tugas persetujuan yang belum diproses milik Karyawan tertentu](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/427d2661-07ff-4d03-af7a-4f131bdb2688.png) Admin mengalihkan tugas yang belum diproses secara massal ke Pengguna lain dalam organisasi: ![Contoh praktik serah terima proses, jendela alih Formulir persetujuan muncul setelah memilih tugas yang belum diproses untuk mengalihkannya secara massal](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/8701c24d-65c9-4751-92d1-6d1ed569b544.png) ### 3. Integrasi pusat proses (Grup bisnis Kustom) Pelanggan ingin memusatkan tugas persetujuan dari beberapa sistem pihak ketiga di Pusat Persetujuan DingTalk untuk pengalaman persetujuan satu pintu yang mendalam. Selain itu, mereka ingin mendukung kategori bisnis Kustom di pusat Tugas DingTalk dan persetujuan sekali klik pada halaman Daftar, sehingga memberikan pengalaman terbaik bagi Pengguna, terutama level manajerial yang memiliki banyak item persetujuan. Mendukung kategori bisnis Kustom di pusat Tugas, sehingga Tugas dari sumber sistem bisnis pihak ketiga lebih jelas ditinjau: ![Perbandingan sebelum dan sesudah praktik Grup bisnis Kustom, Grup Sumber bisnis tingkat kedua baru ditambahkan di bawah kategori Persetujuan OA pada pusat Tugas](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/fe05bb81-8098-450a-a848-b5e288a9f48b.png) Mendukung persetujuan cepat pada halaman Daftar pusat Tugas untuk tugas yang belum diproses dari sistem bisnis pihak ketiga: ![Perbandingan sebelum dan sesudah praktik persetujuan cepat Kustom, halaman Daftar pusat Tugas dapat langsung Terima atau Tolak tugas sistem pihak ketiga](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/55990238-1572-4fde-9b8b-f87ca6f71385.png) ### 4. Integrasi pusat proses (mode hosting Halaman persetujuan) Sistem bisnis pelanggan memiliki mesin proses sendiri dan ingin melakukan integrasi dengan mode Persetujuan OA milik sendiri, tetapi tidak memiliki Halaman detail H5. Mereka ingin menggunakan kembali Halaman detail Persetujuan OA resmi DingTalk dan dapat mengustom area Tindakan persetujuan: menyatukan struktur dan gaya Formulir persetujuan dari berbagai sistem bisnis, sehingga memberikan pengalaman yang konsisten di berbagai perangkat (seluler/PC/tablet) bagi Pengguna; tombol pada area Tindakan persetujuan dapat dikustom (Terima, Tolak, alihkan, Cetak, dll.). Mendukung Persetujuan OA milik pihak ketiga untuk menggunakan gaya Halaman detail resmi: ![Contoh praktik hosting Halaman persetujuan, Formulir persetujuan milik pihak ketiga ditampilkan dengan gaya Halaman detail resmi DingTalk](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/ddd9870e-afc3-435c-bd4e-9da60d0e9b4f.png) Halaman detail seluler juga mendukung kustomisasi area Tindakan persetujuan:
![Halaman detail seluler contoh praktik hosting Halaman persetujuan, area Tindakan di bagian bawah menampilkan tombol Tolak dan Terima yang dikustom](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/92fe8096-a822-44ed-a829-9f6bc754fa75.png)
Mendukung bisnis pihak ketiga untuk mengonfigurasi/merender tombol area Tindakan persetujuan secara Kustom (Terima, Tolak, dll.), serta dapat menampilkan detail teks Error eksekusi bisnis pihak ketiga: ![Perbandingan sebelum dan sesudah praktik hosting Halaman persetujuan, tombol area Tindakan pada Halaman detail PC dapat dikustom dan menampilkan informasi Error](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/bf6fdc33-79d4-45a8-944e-02f0616cc5ff.png) ## 3. Langkah pengoperasian Untuk OpenAPI eksklusif di atas, pelanggan versi Standar perlu **melakukan upgrade ke Smart OA** sebelum dapat mengajukan penggunaannya. Sebagian pelanggan yang telah berpartisipasi dalam beta publik sebelum 1 September 2024 telah memperoleh Izin memanggil OpenAPI ini. Silakan panggil sesuai aturan berikut: | Tipe pelanggan | Berpartisipasi dalam beta publik | Terdampak? | | ----------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Pelanggan Smart OA | Sudah berpartisipasi | Tidak terdampak, tetap dapat memanggil secara normal | | Pelanggan Smart OA | Belum berpartisipasi | Dapat memanggil setelah mengajukan Izin penggunaan API | | Pelanggan versi Standar | Sudah berpartisipasi | Tidak dapat memanggil, perlu upgrade ke Smart OA lalu mengajukan Izin panggilan API untuk melanjutkan pemanggilan; langkah pengajuan Izin dapat merujuk pada penjelasan di bawah | | Pelanggan versi Standar | Belum berpartisipasi | Tidak dapat memanggil, perlu upgrade ke Smart OA lalu mengajukan Izin panggilan API untuk dapat memanggil; langkah pengajuan Izin dapat merujuk pada penjelasan di bawah | Jalur pengajuan Izin: **Developer Backend** > Pengembangan aplikasi > Aplikasi DingTalk > Buat aplikasi baru atau pilih aplikasi yang sudah ada > klik aplikasi > \[Kelola izin] > \[Persetujuan OA], lalu pilih Izin yang ingin diajukan: ![Halaman kelola Izin aplikasi di Developer Backend, centang Izin API yang diajukan pada kategori Persetujuan OA](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/3BMqYybPY69PKqwZ/img/021b73d4-c1fc-4f6f-90a4-9ebe0810cdfb.png) ## 4. FAQ Pelanggan DingTalk versi Standar tidak dapat menggunakan OpenAPI eksklusif Smart OA. Anda perlu **upgrade ke Smart OA** terlebih dahulu sebelum dapat memanggil API ini. Penggunaan OpenAPI eksklusif akan mengurangi kuota OpenAPI Smart OA. Mulai 1 September 2024, developer dapat melihat OpenAPI eksklusif yang telah dirilis pada dokumen developer Open Platform dan di **Developer Backend**. ## 5. Dokumen terkait Ringkasan empat solusi untuk mengintegrasikan sistem bisnis organisasi ke Persetujuan OA DingTalk Diajukan oleh sistem bisnis, membuka Halaman detail persetujuan sistem bisnis di dalam DingTalk