Langsung ke konten utama
Sebelum memanggil API yang terkait dengan Kontak, Anda harus menambahkan izin API Kontak. Gunakan API ini untuk mendapatkan cakupan izin Kontak.

Deskripsi panggilan API

API yang dijelaskan dalam topik ini adalah Server API lama. Untuk detail cara memanggilnya, lihat API lama vs. API baru.
Untuk API yang terkait dengan Kontak, admin harus terlebih dahulu mengajukan izin API yang sesuai di DingTalk Developer Console dan menentukan cakupan Kontak mana yang dapat diakses oleh API tersebut. Seperti ditunjukkan pada gambar di bawah, access_token dari aplikasi saat ini hanya memiliki izin Kontak untuk mengelola departemen A. Developer dapat memanggil API ini terlebih dahulu untuk melihat cakupan otorisasi Kontak dari aplikasi. Saat memanggil API Kontak, developer hanya dapat mengambil informasi Kontak karyawan dalam cakupan yang telah diotorisasi. Mencoba mengambil informasi Kontak karyawan di luar cakupan yang telah diotorisasi akan mengembalikan error The department or employee is not within the authorization scope.

Permintaan

Parameter kueri

Contoh permintaan

Java
Python
PHP
C#

Respons

Isi respons

Contoh isi respons

Kode error

Jika terjadi error saat memanggil API ini, lihat dokumen Kode error global untuk solusi berdasarkan pesan error.