> ## 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. # Mendapatkan detail pengguna > Gunakan API DingTalk untuk mendapatkan detail pengguna akun biasa maupun Akun Perusahaan, termasuk nomor telepon, email, departemen, dan izin Kontak. Panggil API ini untuk mendapatkan detail pengguna tertentu. ## Deskripsi panggilan API API ini memungkinkan Anda mengambil detail pengguna akun biasa atau pengguna Akun Perusahaan. Karena penggunaan parameter berbeda secara signifikan antara kedua skenario tersebut, dokumentasi dipisah berdasarkan jenis akun agar lebih mudah dirujuk: * Untuk mengambil detail pengguna akun biasa, lihat artikel ini. * Untuk mengambil detail pengguna Akun Perusahaan, lihat [Mendapatkan detail pengguna Akun Perusahaan](/id/open/development/queries-the-details-of-a-dedicated-account). Jika Anda perlu memperoleh izin untuk bidang seperti nomor telepon dan email, metodenya berbeda menurut Jenis aplikasi. * Agar Aplikasi internal dapat memperoleh nomor telepon dan email pengguna, tambahkan izin untuk mengakses nomor telepon dan email di Kontak. Untuk menambahkan izin: Masuk ke [DingTalk Developer Console](https://open-dev.dingtalk.io/#/corpeapp) > **Internal Development** > **temukan aplikasi yang ingin Anda tambahkan izinnya** > **Kelola izin** > **Contacts Management**. Pilih **Employee phone number** dan **Mail and other Profile information**, lalu klik Minta izin. * Agar Aplikasi perusahaan pihak ketiga dapat memperoleh nomor telepon dan email pengguna, gunakan DingTalk unified authorization suite. ## Permintaan | **Informasi dasar** | | | ---------------------------- | ---------------------------------------------------------------------------------------- | | URL HTTP | [https://api.dingtalk.io/topapi/v2/user/get](https://api.dingtalk.io/topapi/v2/user/get) | | Metode HTTP | POST | | Jenis aplikasi yang didukung | appType-Internal app, appType-Third-party enterprise app | | Persyaratan izin | permission-qyapi\_get\_member-User information read permission | ### Parameter kueri | Nama | Jenis | Wajib | Contoh | Deskripsi | | ------------- | ------ | ----- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | access\_token | String | Ya | bE74xxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini. - Untuk Aplikasi internal, dapatkan melalui API untuk memperoleh [access\_token Aplikasi internal](/id/open/development/obtain-orgapp-token). - Untuk Aplikasi perusahaan pihak ketiga, dapatkan melalui API untuk memperoleh access\_token perusahaan pihak ketiga. | ### Isi permintaan | Nama | Jenis | Wajib | Contoh | Deskripsi | | -------- | ------ | ----- | ----------- | ----------------------------------------------------------------------- | | userid | String | Ya | manager4220 | userid pengguna. | | language | String | Tidak | zh\_CN | Bahasa Kontak. - **zh\_CN**: Tionghoa (Default) - **en\_US**: Inggris | ### Contoh permintaan ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl -X POST "https://api.dingtalk.io/topapi/v2/user/get" \ -H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \ -d 'access_token=b97a231d-7dd8-4243-ac4e-6b75b2a1e28a' \ -d 'language=zh_CN' \ -d 'userid=zhangsan' ``` Java ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/get"); OapiV2UserGetRequest req = new OapiV2UserGetRequest(); req.setUserid("001"); req.setLanguage("zh_CN"); OapiV2UserGetResponse rsp = client.execute(req, access_token); System.out.println(rsp.getBody()); ``` Python ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} import dingtalk.api req=dingtalk.api.OapiV2UserGetRequest("https://api.dingtalk.io/topapi/v2/user/get") req.userid="zhangsan" req.language="zh_CN" try: resp= req.getResponse(access_token) print(resp) except Exception,e: print(e) ``` PHP ```php theme={"theme":{"light":"github-light","dark":"github-dark"}} include "TopSdk.php"; date_default_timezone_set('Asia/Shanghai'); $c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON); $req = new OapiV2UserGetRequest; $req->setUserid("zhangsan"); $req->setLanguage("zh_CN"); $resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/v2/user/get"); ``` C# ```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}} IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/user/get"); OapiV2UserGetRequest req = new OapiV2UserGetRequest(); req.Userid = "zhangsan"; req.Language = "zh_CN"; OapiV2UserGetResponse rsp = client.Execute(req, access_token); Console.WriteLine(rsp.Body); ``` ## Respons ### Isi respons | Nama | Jenis | Contoh | Deskripsi | | --------------------- | --------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | request\_id | String | 4e7exhl6pm0t | ID permintaan. | | errcode | Number | 0 | Kode pengembalian. | | errmsg | String | ok | Deskripsi kode pengembalian. | | result | Object | | Hasil yang dikembalikan. | | userid | String | zhangsan | userid Karyawan. | | unionid | String | z21HjQliSzpw0YWCNxmii6u2Os62cZ62iSZ | Pengenal unik Karyawan dalam cakupan akun perusahaan developer saat ini. | | name | String | John | Nama Karyawan. | | avatar | String | xxx | Foto Profil. **Catatan** Jika Karyawan menggunakan Foto Profil default, bidang ini tidak dikembalikan. Bidang ini hanya dikembalikan saat Foto Profil diatur secara manual. | | state\_code | String | 86 | Kode panggilan negara internasional. **Catatan** Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. Untuk memperoleh state\_code, gunakan DingTalk unified authorization suite. | | manager\_userid | String | user01 | Manajer langsung Karyawan. **Catatan** Bidang ini hanya dikembalikan saat bidang **Direct Manager** pada panel Profil Karyawan di konsol admin perusahaan memiliki nilai. | | mobile | String | 13800138000 | Nomor telepon. **Catatan** - Untuk Aplikasi internal, bidang ini hanya dikembalikan saat Aplikasi telah diberi izin **Employee phone number** di Kontak. - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. Untuk memperoleh mobile, gunakan DingTalk unified authorization suite. | | hide\_mobile | Boolean | false | Apakah nomor telepon disembunyikan: - **true**: disembunyikan - **false**: tidak disembunyikan **Catatan** Saat nomor telepon disembunyikan, nomor tersebut disembunyikan pada halaman Profil, tetapi Anda tetap dapat mengirim pesan DING dan memulai panggilan bisnis DingTalk gratis ke nomor tersebut. | | telephone | String | 010-86123456-2345 | Nomor ekstensi. **Catatan** Parameter ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | job\_number | String | 4 | ID Karyawan. | | title | String | Technical Director | Jabatan. | | email | String | [test@xxx.com](mailto:test@xxx.com) | Email Karyawan. **Catatan** - Untuk Aplikasi internal, bidang ini hanya dikembalikan saat Aplikasi telah diberi izin **Mail and other Profile information** di Kontak. - Parameter ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. Untuk memperoleh email, gunakan DingTalk unified authorization suite. | | work\_place | String | Future Park | Lokasi Kerja. **Catatan** - Bidang ini hanya dikembalikan saat memiliki nilai pada panel Profil Karyawan. Jika kosong, bidang ini tidak dikembalikan. - Untuk Aplikasi internal, bidang ini hanya dikembalikan saat Aplikasi telah diberi izin **Mail and other Profile information** di Kontak. - Parameter ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | remark | String | Remark | Alias. **Catatan** - Bidang ini hanya dikembalikan saat memiliki nilai pada panel Profil Karyawan. Jika kosong, bidang ini tidak dikembalikan. - Untuk Aplikasi internal, bidang ini hanya dikembalikan saat Aplikasi telah diberi izin **Mail and other Profile information** di Kontak. - Parameter ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | exclusive\_account | Boolean | false | Apakah pengguna adalah Akun Perusahaan: - true: ya - false: tidak | | org\_email | String | [test@xxx.com](mailto:test@xxx.com) | Email Perusahaan Karyawan. Jika Email Perusahaan Karyawan tidak diaktifkan, data ini tidak disertakan dalam respons. **Catatan** Parameter ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | dept\_id\_list | Number\[] | \[2,3,4] | Daftar ID departemen tempat Karyawan bernaung. | | dept\_order\_list | Object\[] | | Urutan Karyawan dalam setiap Departemen. | | dept\_id | Number | 2 | ID departemen. | | order | Number | 1 | Urutan Karyawan dalam Departemen. | | extension | String | `{"Hobby":"Travel","Age":"24"}` | Atribut yang diperluas, hingga 2000 karakter panjangnya. **Catatan** - Hanya dikembalikan saat Bidang yang diperluas yang ditambahkan pada panel Profil Karyawan memiliki nilai. - Untuk Aplikasi internal, bidang ini hanya dikembalikan saat Aplikasi telah diberi izin **Mail and other Profile information** di Kontak. - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. - **Penting**: Menambahkan Atribut baru secara langsung akan menimpa nilai Atribut yang ada. Ambil terlebih dahulu Atribut yang ada, tambahkan Atribut baru, lalu lakukan Perbarui penuh. | | hired\_date | Number | 1597573616828 | Tanggal perekrutan. Unix timestamp dalam milidetik. **Catatan** - Hanya dikembalikan saat bidang **Hire Date** pada panel Profil memiliki nilai. - Parameter ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | active | Boolean | true | Apakah DingTalk telah diaktifkan: - **true**: diaktifkan - **false**: tidak diaktifkan | | real\_authed | Boolean | true | Apakah Autentikasi nama asli telah selesai: - **true**: terverifikasi - **false**: tidak terverifikasi | | senior | Boolean | true | Apakah Karyawan adalah eksekutif Organisasi: - **true**: ya - **false**: tidak | | admin | Boolean | true | Apakah Karyawan adalah Admin Organisasi: - **true**: ya - **false**: tidak | | boss | Boolean | true | Apakah Karyawan adalah bos Organisasi: - **true**: ya - **false**: tidak | | leader\_in\_dept | Object\[] | | Informasi Departemen Karyawan dan apakah Karyawan adalah pemimpin: - ID Departemen tempat Karyawan bernaung. - Apakah Karyawan adalah pemimpin di Departemen terkait: - true: ya - false: tidak | | dept\_id | Number | 2 | ID Departemen. | | leader | Boolean | true | Apakah Karyawan adalah pemimpin: - **true**: ya - **false**: tidak | | role\_list | Object\[] | | Daftar Peran. | | id | Number | 100 | ID Peran. | | name | String | Director | Nama Peran. | | group\_name | String | Position | Nama Grup peran. | | union\_emp\_ext | Object | | Informasi Asosiasi saat pengguna berasal dari Organisasi yang terasosiasi. **Catatan** Bidang ini dikembalikan saat Organisasi tempat pengguna bernaung memiliki hubungan Asosiasi dengan Organisasi lain. | | userid | String | 500 | userid Karyawan. | | union\_emp\_map\_list | Object\[] | | Pemetaan Asosiasi. | | userid | String | 5000 | userid Karyawan di Organisasi cabang yang terasosiasi. | | corp\_id | String | dingxxx | corpId Organisasi cabang yang terasosiasi. | | corp\_id | String | dingxxx | corpId Organisasi tempat pengguna saat ini bernaung. | | dept\_position\_list | DeptPosition\[] | | Informasi posisi dalam Departemen. | | extension\_i18n | Json | `{"Hobby": {"zh_CN": "旅游", "en_US": "travel", "aJP": "旅行"}}` | Nilai terinternasionalisasi dari Atribut yang diperluas. | ### Contoh isi respons ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "errcode":"0", "result":{ "extension":"{\"Hobby\":\"Travel\",\"Age\":\"24\"}", "unionid":"z21HjQliSzpw0YWxxxxx", "boss":"true", "role_list":{ "group_name":"Position", "name":"Director", "id":"100" }, "exclusive_account":false, "manager_userid":"manager240", "admin":"true", "remark":"Remark", "title":"Technical Director", "hired_date":"1597573616828", "userid":"zhangsan", "work_place":"Future Park", "dept_order_list":{ "dept_id":"2", "order":"1" }, "real_authed":"true", "dept_id_list":"[2,3,4]", "job_number":"4", "email":"test@xxx.com", "leader_in_dept":{ "leader":"true", "dept_id":"2" }, "mobile":"13800138000", "active":"true", "org_email":"test@xxx.com", "telephone":"010-86123456-2345", "avatar":"xxx", "hide_mobile":"false", "senior":"true", "name":"John", "union_emp_ext":{ "union_emp_map_list":{ "userid":"5000", "corp_id":"dingxxx" }, "userid":"500", "corp_id":"dingxxx" }, "state_code":"86" }, "errmsg":"ok" } ``` ### Kode error Jika panggilan API mengembalikan Error, cari solusinya berdasarkan Pesan error di dokumentasi [Kode error global](/id/open/development/server-api-error-codes-1). | Kode error (errcode) | Deskripsi kode error (errmsg) | Solusi | | -------------------- | ----------------------------- | ----------------------------------------------------- | | 33012 | Invalid userid | Periksa apakah userid sudah benar. | | 400002 | Invalid parameter | Periksa apakah parameter dimasukkan sesuai ketentuan. | | -1 | System busy | Coba Lagi Nanti. |