> ## 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 informasi dasar pengguna departemen > Panggil API DingTalk ini untuk mendapatkan informasi dasar pengguna dalam departemen tertentu — ideal untuk menampilkan daftar pengguna ringan seperti userId dan nama secara efisien. Panggil API ini untuk mendapatkan informasi dasar pengguna dalam departemen tertentu. ## Deskripsi panggilan API * API ini hanya mengembalikan field userId dan name dari pengguna. Untuk mendapatkan informasi pengguna yang lebih detail, lihat [Mendapatkan informasi lengkap pengguna departemen](/id/open/development/queries-the-complete-information-of-a-department-user). * API ini hanya mengembalikan informasi dasar pengguna di departemen saat ini. Informasi pengguna di sub-departemen tidak dikembalikan. ## Permintaan | **Informasi dasar** | | | --------------------------- | ------------------------------------------------------------------------------------------------ | | URL HTTP | [https://api.dingtalk.io/topapi/user/listsimple](https://api.dingtalk.io/topapi/user/listsimple) | | Metode HTTP | POST | | Tipe aplikasi yang didukung | appType-Aplikasi internal appType-Aplikasi perusahaan pihak ketiga | | Izin | permission-qyapi\_get\_department\_member-Izin baca untuk pengguna departemen Kontak | ### Parameter kueri | Nama | Tipe | Wajib | Contoh | Deskripsi | | ------------- | ------ | ----- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | access\_token | String | Ya | bE74xxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini. - Untuk aplikasi internal, dapatkan melalui API yang mendapatkan [access\_token dari aplikasi internal](/id/open/development/obtain-orgapp-token). - Untuk aplikasi perusahaan pihak ketiga, dapatkan melalui API yang mendapatkan access\_token dari perusahaan pihak ketiga. | ### Isi permintaan | Nama | Tipe | Wajib | Contoh | Deskripsi | | ---------------------- | ------- | ----- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | dept\_id | Number | Ya | 10 | ID departemen. Untuk departemen root, gunakan 1. Panggil [Mendapatkan daftar departemen](/id/open/development/user-management-acquires-the-list-departments) untuk mendapatkan nilai dept\_id. | | cursor | Number | Ya | 0 | Cursor untuk paginasi. Gunakan 0 untuk permintaan pertama, dan gunakan nilai next\_cursor dari respons pada permintaan berikutnya. | | size | Number | Ya | 10 | Ukuran halaman. Nilai maksimum adalah 100. | | order\_field | String | Tidak | modify\_desc | Aturan pengurutan untuk pengguna departemen. Nilai default adalah **custom**. - **entry\_asc**: urutkan berdasarkan waktu bergabung ke departemen secara menaik. - **entry\_desc**: urutkan berdasarkan waktu bergabung ke departemen secara menurun. - **modify\_asc**: urutkan berdasarkan waktu modifikasi informasi departemen secara menaik. - **modify\_desc**: urutkan berdasarkan waktu modifikasi informasi departemen secara menurun. - **custom**: pengurutan yang ditentukan pengguna (diurutkan berdasarkan pinyin jika tidak ditentukan). | | contain\_access\_limit | Boolean | Tidak | false | Apakah akan mengembalikan pengguna dengan akses terbatas. - **true**: Ya - **false**: Tidak | | language | String | Tidak | zh\_CN | Bahasa Kontak. - **zh\_CN**: Bahasa Tionghoa (default). - **en\_US**: Bahasa Inggris. | ### Contoh permintaan ```curl theme={"theme":{"light":"github-light","dark":"github-dark"}} curl -X POST "https://api.dingtalk.io/topapi/user/listsimple" \ -H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \ -d 'access_token=c1f2d110-4e7c-4536-a340-06652613e0c1' \ -d 'contain_access_limit=false' \ -d 'cursor=0' \ -d 'dept_id=10' \ -d 'language=zh_CN' \ -d 'order_field=modify_desc' \ -d 'size=10' ``` Java ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/user/listsimple"); OapiUserListsimpleRequest req = new OapiUserListsimpleRequest(); req.setDeptId(10L); req.setCursor(0L); req.setSize(10L); req.setOrderField("modify_desc"); req.setContainAccessLimit(false); req.setLanguage("zh_CN"); OapiUserListsimpleResponse 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.OapiUserListsimpleRequest("https://api.dingtalk.io/topapi/user/listsimple") req.dept_id=10 req.cursor=0 req.size=10 req.order_field="modify_desc" req.contain_access_limit=false 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 OapiUserListsimpleRequest; $req->setDeptId("10"); $req->setCursor("0"); $req->setSize("10"); $req->setOrderField("modify_desc"); $req->setContainAccessLimit("false"); $req->setLanguage("zh_CN"); $resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/user/listsimple"); ``` C# ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/user/listsimple"); OapiUserListsimpleRequest req = new OapiUserListsimpleRequest(); req.DeptId = 10L; req.Cursor = 0L; req.Size = 10L; req.OrderField = "modify_desc"; req.Language = "zh_CN"; req.ContainAccessLimit = false; req.Language = "zh_CN"; OapiUserListsimpleResponse rsp = client.Execute(req, access_token); Console.WriteLine(rsp.Body); ``` ## Respons ### Isi respons | Nama | Tipe | Contoh | Deskripsi | | ------------ | ------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------- | | request\_id | String | 4f9md9obopn2 | ID permintaan. | | errcode | Number | 0 | Kode pengembalian. 0 menunjukkan berhasil. | | errmsg | String | ok | Deskripsi kode pengembalian. | | result | PageResult | | Hasil yang dikembalikan. | | has\_more | Boolean | true | Apakah tersedia data lebih lanjut. - **true**: Ya - **false**: Tidak | | next\_cursor | Number | 10 | Cursor untuk halaman berikutnya. Jika has\_more bernilai false, tidak ada lagi data paginasi yang tersedia. | | list | ListUserSimpleResponse\[] | | Daftar informasi pengguna. | | userid | String | zxxxxx | userid dari pengguna. | | name | String | Zhang San | Nama pengguna. | ### Contoh isi respons ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "errcode": 0, "errmsg": "ok", "result": { "has_more": false, "list": [ { "name": "Pengguna Uji 2", "userid": "user100" }, { "name": "Li Si", "userid": "user1" } ] }, "request_id": "x4p6arvi0fzj" } ``` ### Kode error Jika terjadi error saat Anda memanggil API ini, temukan solusinya di dokumen [Kode error global](/id/open/development/server-api-error-codes-1) berdasarkan pesan error. | Kode error (errcode) | Pesan error (errmsg) | Solusi | | -------------------- | --------------------------- | ---------------------------------------------------- | | 400002 | Invalid parameter | Pastikan parameter diisi sesuai persyaratan di atas. | | 60003 | The department is not found | Pastikan ID departemen sudah benar. | | 40069 | Invalid size | Sesuaikan ukuran halaman. | | 40068 | Invalid offset | Sesuaikan offset. | | -1 | System busy | Coba lagi nanti. |