> ## 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 Akun Perusahaan > Panggil API DingTalk ini untuk mendapatkan detail pengguna Akun Perusahaan tertentu, termasuk nomor ponsel, email, dan jabatan. Hanya tersedia bagi organisasi yang telah mengaktifkan Akun Perusahaan. Panggil API ini untuk mendapatkan informasi detail dari pengguna Akun Perusahaan tertentu. API ini hanya tersedia untuk organisasi yang telah membeli dan mengaktifkan Akun Perusahaan. ## Deskripsi panggilan API Cara mendapatkan izin seperti nomor ponsel dan email berbeda menurut jenis aplikasi. * Aplikasi internal Untuk mendapatkan informasi nomor ponsel dan email pengguna, Aplikasi internal harus menambahkan izin untuk mengakses nomor ponsel dan email di Kontak. Untuk menambahkan izin: Masuk ke [DingTalk Developer Platform](https://open-dev.dingtalk.io/#/corpeapp) > **Internal development** > temukan aplikasi yang memerlukan izin > **Kelola izin** > **Contacts management**, pilih **Mobile number information of employees** dan **Email and other profile information**, lalu klik Minta izin. * Aplikasi perusahaan pihak ketiga ## 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-Aplikasi internal, appType-Aplikasi perusahaan pihak ketiga | | Izin yang wajib | permission-qyapi\_get\_member-Izin baca untuk informasi pengguna | ### Parameter query | Nama | Jenis | Wajib | Contoh | Deskripsi | | ------------- | ------ | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | access\_token | String | Ya | be3Fxxxx | Kredensial aplikasi untuk memanggil API ini. - Untuk Aplikasi internal, dapatkan melalui API untuk mendapatkan [access\_token dari Aplikasi internal](/id/open/development/obtain-orgapp-token). - Untuk Aplikasi perusahaan pihak ketiga, dapatkan melalui API untuk mendapatkan access\_token dari perusahaan pihak ketiga. | ### Isi permintaan | Nama | Jenis | Wajib | Contoh | Deskripsi | | --------- | ------ | ----- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | userid | String | Ya | manager4220 | ID pengguna dari pengguna. | | language | String | Tidak | zh\_CN | Bahasa untuk Kontak. - **zh\_CN**: Bahasa Tiongkok (default) - **en\_US**: Bahasa Inggris | | login\_id | String | Tidak | test | Nama masuk. Ketika bidang ini tidak kosong, userid diabaikan. **Catatan** Kueri berdasarkan nama masuk hanya didukung untuk Akun Perusahaan bawaan DingTalk yang menjadi milik Organisasi Anda. | ### Contoh permintaan ```curl 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=a894388c-a1b9-4ab4-8623-99cd0502019f' \ -d 'language=zh_CN' \ -d 'login_id=zhangsan' \ -d 'userid=zhangsan' ``` Java ```text 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("zhangsan"); req.setLanguage("zh_CN"); req.setLoginId("zhangsan"); 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" req.login_id="zhangsan" 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"); $req->setLoginId("zhangsan"); $resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/v2/user/get"); ``` C# ```text 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"; req.LoginId = "zhangsan"; 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 | ID pengguna dari karyawan. | | unionid | String | z21HjQliSzpw0YWCNxmii6u2Os62cZ62iSZ | Identifier unik dari karyawan dalam cakupan Akun Perusahaan dari developer saat ini. | | name | String | John | Nama karyawan. | | avatar | String | xxx | Foto Profil. **Catatan** - Bidang ini tidak dikembalikan jika karyawan menggunakan Foto Profil default. - Bidang ini dikembalikan jika karyawan telah menetapkan Foto Profil secara manual. | | state\_code | String | 86 | Kode panggilan internasional. **Catatan** Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. Untuk mendapatkan state\_code, gunakan suite otorisasi terpadu DingTalk. | | mobile | String | 13800138000 | Nomor ponsel. **Catatan** - Jika Aplikasi internal tidak menerima bidang ini, periksa apakah izin **Mobile number information of employees** diaktifkan dalam izin Kontak dari aplikasi saat ini. - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. Untuk mendapatkan mobile, gunakan suite otorisasi terpadu DingTalk. | | hide\_mobile | Boolean | false | Apakah nomor ponsel disembunyikan: - **true**: disembunyikan - **false**: tidak disembunyikan **Catatan** Setelah nomor ponsel disembunyikan, nomor tersebut disembunyikan pada halaman Profil, tetapi Anda tetap dapat mengirim pesan DING dan memulai panggilan bisnis DingTalk ke pengguna. | | telephone | String | 010-86123456-2345 | Nomor ekstensi. **Catatan** Bidang 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** - Jika Aplikasi internal tidak menerima bidang ini, periksa apakah izin **Email and other profile information** diaktifkan dalam izin Kontak dari aplikasi saat ini. - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. Untuk mendapatkan email, gunakan suite otorisasi terpadu DingTalk. | | org\_email | String | [test@xxx.com](mailto:test@xxx.com) | Email Perusahaan dari karyawan. Data ini tidak disertakan dalam respons jika Email Perusahaan karyawan tidak diaktifkan. **Catatan** Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | work\_place | String | Future Park | Lokasi Kerja. **Catatan** - Jika Aplikasi internal tidak menerima bidang ini, periksa apakah izin **Email and other profile information** diaktifkan dalam izin Kontak dari aplikasi saat ini. - Bidang ini dikembalikan hanya ketika terdapat nilai pada bidang ini di panel informasi karyawan. - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | remark | String | Remark | Alias. **Catatan** - Jika Aplikasi internal tidak menerima bidang ini, periksa apakah izin **Email and other profile information** diaktifkan dalam izin Kontak dari aplikasi saat ini. - Bidang ini dikembalikan hanya ketika terdapat nilai pada bidang ini di panel informasi karyawan. - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | dept\_id\_list | Number\[] | \[2,3,4] | Daftar ID departemen yang menjadi tempat karyawan bernaung. | | dept\_order\_list | Object\[] | | Urutan pengurutan karyawan di setiap departemen. | | dept\_id | Number | 2 | ID departemen. | | order | Number | 1 | Urutan pengurutan karyawan di dalam departemen. | | extension | String | `{"Hobby":"Travel","Age":"24"}` | Atribut yang diperluas. Panjang maksimum adalah 2.000 karakter. **Catatan** - Jika Aplikasi internal tidak menerima bidang ini, periksa apakah izin **Email and other profile information** diaktifkan dalam izin Kontak dari aplikasi saat ini. - Bidang ini dikembalikan hanya ketika bidang yang diperluas yang ditambahkan pada panel informasi karyawan berisi nilai. - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. | | hired\_date | Number | 1597573616828 | Tanggal perekrutan, sebagai Unix timestamp dalam milidetik. **Catatan** - Bidang ini tidak dikembalikan untuk Aplikasi perusahaan pihak ketiga. - Bidang ini dikembalikan hanya ketika bidang **Hire date** pada panel informasi memiliki nilai. | | active | Boolean | true | Apakah DingTalk telah diaktifkan: - **true**: diaktifkan - **false**: tidak diaktifkan | | real\_authed | Boolean | true | Apakah autentikasi nama asli telah diselesaikan: - **true**: terautentikasi - **false**: tidak terautentikasi | | senior | Boolean | true | Apakah pengguna adalah eksekutif senior dari organisasi: - **true**: ya - **false**: tidak | | admin | Boolean | true | Apakah pengguna adalah admin dari organisasi: - **true**: ya - **false**: tidak | | boss | Boolean | true | Apakah pengguna adalah bos dari organisasi: - **true**: ya - **false**: tidak | | leader\_in\_dept | Object\[] | | Informasi tentang departemen yang menjadi tempat karyawan bernaung dan apakah karyawan adalah pemimpin di masing-masing: - ID departemen dari departemen yang menjadi tempat karyawan bernaung. - Apakah karyawan adalah pemimpin di departemen yang bersangkutan: - true: ya - false: tidak | | dept\_id | Number | 2 | ID departemen. | | leader | Boolean | true | Apakah pengguna 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. | | exclusive\_account | Boolean | true | Apakah pengguna adalah Akun Perusahaan: - true: ya - false: tidak | | union\_emp\_ext | Object | | Informasi asosiasi ketika pengguna berasal dari organisasi terasosiasi. **Catatan** Bidang ini dikembalikan ketika organisasi pengguna memiliki organisasi terasosiasi. | | userid | String | 500 | ID pengguna dari karyawan. | | union\_emp\_map\_list | Object\[] | | Pemetaan asosiasi. | | userid | String | 5000 | ID pengguna dari karyawan di organisasi cabang terasosiasi. | | corp\_id | String | dingxxx | Corp ID dari organisasi cabang terasosiasi. | | corp\_id | String | dingxxx | Corp ID dari organisasi yang menjadi tempat pengguna saat ini bernaung. | | exclusive\_account\_type | String | dingtalk | Jenis Akun Perusahaan: - **sso**: Akun Perusahaan yang dibangun sendiri oleh organisasi - **dingtalk**: Akun Perusahaan bawaan DingTalk **Catatan** Bidang ini dikembalikan hanya untuk Akun Perusahaan. | | login\_id | String | login\_id3 | Nama masuk dari Akun Perusahaan bawaan DingTalk. **Catatan** Bidang ini dikembalikan hanya untuk Akun Perusahaan DingTalk yang menjadi milik Organisasi Anda. | | manager\_userid | String | manager240 | Manajer langsung dari karyawan. **Catatan** Bidang ini dikembalikan hanya ketika bidang **Direct manager** pada panel profil karyawan di admin console organisasi memiliki nilai. | | org\_email\_type | String | profession | Jenis Email Perusahaan dari karyawan: - **profession**: Standar - **base**: Dasar | | nickname | String | Name | Nama karyawan. **Catatan** Bidang ini dikembalikan hanya untuk Akun Perusahaan DingTalk yang menjadi milik Organisasi Anda. | | exclusive\_account\_corp\_name | String | Organization name | Nama dari organisasi yang menjadi tempat Akun Perusahaan bernaung. **Catatan** Ini hanya berlaku untuk Akun Perusahaan dan mengembalikan organisasi yang membuat Akun Perusahaan. | | exclusive\_account\_corp\_id | String | dingxxx | Corp ID dari organisasi yang menjadi tempat Akun Perusahaan bernaung. **Catatan** Ini hanya berlaku untuk Akun Perusahaan dan mengembalikan organisasi yang membuat Akun Perusahaan. | | disable\_status | Boolean | false | Status dinonaktifkan dari Akun Perusahaan di Organisasi Anda: - **true**: dinonaktifkan - **false**: diaktifkan **Catatan** Bidang ini dikembalikan hanya untuk Akun Perusahaan DingTalk yang menjadi milik Organisasi Anda. | ### Contoh isi respons ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "errcode":"0", "result":{ "exclusive_account_type":"dingtalk", "extension":"{\"Hobby\":\"Travel\",\"Age\":\"24\"}", "unionid":"z21HjQliSzpw0YWCNxmii6u2Os62cZ62iSZ", "boss":"true", "role_list":{ "group_name":"Position", "name":"Director", "id":"100" }, "exclusive_account":"true", "manager_userid":"manager240", "admin":"true", "remark":"Remark", "title":"Technical Director", "hired_date":"1597573616828", "userid":"zhangsan", "org_email_type":"profession", "work_place":"Future Park", "dept_order_list":{ "dept_id":"2", "order":"1" }, "real_authed":"true", "nickname":"Name", "dept_id_list":"[2,3,4]", "job_number":"4", "email":"test@xxx.com", "leader_in_dept":{ "leader":"true", "dept_id":"2" }, "login_id":"login_id3", "exclusive_account_corp_name":"Organization name", "mobile":"13800138000", "active":"true", "telephone":"010-86123456-2345", "avatar":"xxx", "hide_mobile":"false", "exclusive_account_corp_id":"dingxxx", "senior":"true", "org_email":"test@xxx.com", "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 terjadi error saat memanggil API ini, cari solusinya di dokumen [Global error codes](/id/open/development/server-api-error-codes-1) berdasarkan pesan error. | Kode error (errcode) | Pesan error (errmsg) | Solusi | | -------------------- | -------------------- | ------------------------------------------------------------- | | 33012 | Invalid userId | Periksa apakah userId sudah benar. | | 400002 | Invalid parameter | Verifikasi bahwa parameter dimasukkan sesuai yang diwajibkan. | | -1 | The system is busy | Coba lagi nanti. |