> ## 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 departemen

> Panggil API ini untuk mendapatkan detail departemen tertentu berdasarkan ID departemen di DingTalk, termasuk nama, departemen induk, obrolan, dan pengaturan visibilitas Kontak.

Panggil API ini untuk mendapatkan detail departemen tertentu berdasarkan ID departemennya.

## Permintaan

| **Informasi dasar**         |                                                                                                      |
| --------------------------- | ---------------------------------------------------------------------------------------------------- |
| URL HTTP                    | [https://api.dingtalk.io/topapi/v2/department/get](https://api.dingtalk.io/topapi/v2/department/get) |
| Metode HTTP                 | POST                                                                                                 |
| Tipe aplikasi yang didukung | appType-Internal app, appType-Third-party enterprise app                                             |
| Izin yang dibutuhkan        | permission-qyapi\_get\_department\_list-Izin baca untuk informasi departemen Kontak                  |

### Parameter query

| Nama          | Tipe   | Wajib | Contoh   | Deskripsi                                                                                                                                                                                                                                                                                                                                              |
| ------------- | ------ | ----- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| access\_token | String | Ya    | bE74xxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini.   - Untuk aplikasi internal, dapatkan dengan memanggil API untuk mendapatkan [access\_token aplikasi internal](/id/open/development/obtain-orgapp-token). - Untuk aplikasi perusahaan pihak ketiga, dapatkan dengan memanggil API untuk mendapatkan access\_token perusahaan pihak ketiga. |

### Isi permintaan

| Nama     | Tipe   | Wajib | Contoh | Deskripsi                                                                                                                                                                                    |
| -------- | ------ | ----- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| dept\_id | Number | Ya    | 100    | ID departemen. ID Departemen root adalah 1. Panggil API [Mendapatkan daftar departemen](/id/open/development/user-management-acquires-the-list-departments) untuk memperoleh nilai dept\_id. |
| language | String | Tidak | zh\_CN | Bahasa Kontak:   - **zh\_CN** (default): Bahasa Mandarin - **en\_US**: Bahasa Inggris                                                                                                        |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/v2/department/get" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=d3daxxxx51990' \
-d 'dept_id=100' \
-d 'language=zh_CN'
```

Java

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/get");
OapiV2DepartmentGetRequest req = new OapiV2DepartmentGetRequest();
req.setDeptId(100L);
req.setLanguage("zh_CN");
OapiV2DepartmentGetResponse 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.OapiV2DepartmentGetRequest("https://api.dingtalk.io/topapi/v2/department/get")

req.dept_id=100
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 OapiV2DepartmentGetRequest;
$req->setDeptId("100");
$req->setLanguage("zh_CN");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/v2/department/get");
```

C#

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/get");
OapiV2DepartmentGetRequest req = new OapiV2DepartmentGetRequest();
req.DeptId = 100L;
req.Language = "zh_CN";
OapiV2DepartmentGetResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama                        | Tipe            | Contoh             | Deskripsi                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------------------- | --------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| request\_id                 | String          | 4e7ljtq91rgo       | ID permintaan.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| errcode                     | Number          | 0                  | Kode kembalian.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| errmsg                      | String          | ok                 | Pesan error.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| result                      | DeptGetResponse |                    | Detail departemen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| dept\_id                    | Number          | 100                | ID departemen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| name                        | String          | HR                 | Nama departemen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| parent\_id                  | Number          | 50                 | ID departemen induk. ID Departemen root adalah 1.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| source\_identifier          | String          | HR                 | Bidang identifier departemen.  **Catatan**  Parameter ini tidak dikembalikan untuk aplikasi perusahaan pihak ketiga.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| create\_dept\_group         | Boolean         | true               | Apakah membuat obrolan perusahaan yang terkait dengan departemen ini secara sinkron:   - **true**: Buat - **false**: Jangan buat                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| auto\_add\_user             | Boolean         | false              | Apakah pengguna baru yang bergabung ke departemen otomatis ditambahkan ke obrolan departemen setelah obrolan dibuat:   - **true**: Otomatis bergabung ke obrolan - **false**: Jangan otomatis bergabung ke obrolan                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| tags                        | String          | campus             | Tag departemen pendidikan:   - **campus**: Kampus - **period**: Periode - **grade**: Tingkat - **class**: Kelas   **Catatan**  Parameter ini tidak dikembalikan untuk aplikasi perusahaan pihak ketiga.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| from\_union\_org            | Boolean         | false              | Apakah departemen berasal dari organisasi yang terkait:   - **true**: Ya - **false**: Tidak   **Catatan**  Parameter ini tidak dikembalikan untuk aplikasi perusahaan pihak ketiga.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| order                       | Number          | 10                 | Nilai urutan dalam departemen induk.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| dept\_group\_chat\_id       | String          | 123                | ID obrolan departemen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| group\_contain\_sub\_dept   | Boolean         | true               | Apakah obrolan departemen mencakup sub-departemen:   - **true**: Termasuk - **false**: Tidak termasuk                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| org\_dept\_owner            | String          | 80                 | ID pengguna pemilik grup obrolan perusahaan.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| dept\_manager\_userid\_list | String\[]       | \["5","6","7","8"] | Daftar ID pengguna manajer departemen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| outer\_dept                 | Boolean         | true               | Apakah membatasi anggota departemen ini untuk melihat Kontak:   - **true**: Pembatasan diaktifkan. Setelah diaktifkan, anggota departemen ini **hanya dapat melihat Kontak dari departemen/pengguna tertentu**. - **false**: Tidak ada pembatasan                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| outer\_permit\_depts        | Number\[]       | \[500,600]         | Daftar ID departemen yang terlihat oleh karyawan departemen.  **Catatan**  Ketika organisasi membatasi anggota departemen ini untuk melihat Kontak, nilai **outer\_dept** dikembalikan.   - **Pembatasan diaktifkan untuk anggota departemen ini melihat Kontak** (yaitu **outer\_dept** bernilai **true**): outer\_permit\_depts menunjukkan **daftar ID departemen** dari **departemen/pengguna tertentu** yang dapat dilihat anggota.   **Catatan**  Misalnya, organisasi membatasi anggota departemen ini untuk melihat Kontak, dan anggota departemen ini diatur agar hanya dapat melihat Kontak dari 2 departemen tertentu dan 2 karyawan tertentu. ID departemen dari Departemen Uji 1 adalah 1 dan ID departemen dari Departemen Uji 2 adalah 2.  Saat memanggil API ini, nilai outer\_permit\_depts yang diperoleh adalah \[1,2]. Daftar karyawan tidak dikembalikan, yaitu informasi Karyawan Xiaoding 1 dan Karyawan Xiaoding 2 tidak dikembalikan.   - **Pembatasan tidak diaktifkan untuk anggota departemen ini melihat Kontak** (yaitu **outer\_dept** bernilai **false**): Bidang outer\_permit\_depts tidak dikembalikan.                           |
| outer\_permit\_users        | String\[]       | \["78","79"]       | Daftar ID pengguna karyawan yang terlihat oleh karyawan departemen.  **Catatan**  Ketika organisasi membatasi anggota departemen ini untuk melihat Kontak, nilai **outer\_dept** dikembalikan.     - **Pembatasan diaktifkan untuk anggota departemen ini melihat Kontak** (yaitu **outer\_dept** bernilai **true**): outer\_permit\_users menunjukkan **daftar ID pengguna karyawan** dari **departemen/pengguna tertentu** yang dapat dilihat anggota.   **Catatan**  Misalnya, organisasi membatasi anggota departemen ini untuk melihat Kontak, dan anggota departemen ini diatur agar hanya dapat melihat Kontak dari 2 departemen tertentu dan 2 karyawan tertentu. ID pengguna dari Karyawan Xiaoding 1 adalah 001 dan ID pengguna dari Karyawan Xiaoding 2 adalah 002.  Saat memanggil API ini, nilai outer\_permit\_users yang diperoleh adalah \["001","002"]. Daftar departemen tidak dikembalikan, yaitu informasi Departemen Uji 1 dan Departemen Uji 2 tidak dikembalikan.   - **Pembatasan tidak diaktifkan untuk anggota departemen ini melihat Kontak** (yaitu **outer\_dept** bernilai **false**): Bidang outer\_permit\_users tidak dikembalikan. |
| user\_permits               | String\[]       | \["5","9"]         | Daftar ID pengguna karyawan untuk departemen yang disembunyikan.  **Catatan**  Ketika organisasi mengaktifkan penyembunyian departemen ini, nilai **hide\_dept** dikembalikan.   - **Penyembunyian departemen ini diaktifkan** (yaitu hide\_dept bernilai true): user\_permits menunjukkan **daftar ID pengguna karyawan** yang **diizinkan terlihat oleh departemen/pengguna tertentu**.  **Catatan**  Misalnya, organisasi mengaktifkan penyembunyian departemen ini dan mengatur 2 departemen serta 2 karyawan agar terlihat oleh departemen/pengguna tertentu. ID pengguna dari Karyawan Xiaoding 1 adalah 001 dan ID pengguna dari Karyawan Xiaoding 2 adalah 002.  Saat memanggil API ini, nilai user\_permits yang diperoleh adalah \["001","002"]. Daftar departemen tidak dikembalikan, yaitu informasi Departemen Uji 1 dan Departemen Uji 2 tidak dikembalikan. - **Penyembunyian departemen ini tidak diaktifkan** (yaitu hide\_dept bernilai false): Bidang user\_permits tidak dikembalikan.                                                                                                                                                           |
| hide\_dept                  | Boolean         | false              | Apakah mengaktifkan penyembunyian departemen ini:   - **true**: Penyembunyian departemen ini diaktifkan. Anda dapat mengatur cakupan penyembunyian, seperti menyembunyikan dari semua pengguna dan departemen, atau mengizinkan visibilitas ke departemen/pengguna tertentu. - **false**: Penyembunyian departemen ini dinonaktifkan. Artinya, departemen ditampilkan di Kontak perusahaan.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| dept\_permits               | Number\[]       | \[3,4,5]           | Daftar ID departemen untuk departemen yang disembunyikan.  **Catatan**  Ketika organisasi mengaktifkan penyembunyian departemen ini, nilai **hide\_dept** dikembalikan.   - **Penyembunyian departemen ini diaktifkan** (yaitu hide\_dept bernilai true): dept\_permits menunjukkan **daftar ID departemen** yang **diizinkan terlihat oleh departemen/pengguna tertentu**.  **Catatan**  Misalnya, organisasi mengaktifkan penyembunyian departemen ini dan mengatur 2 departemen serta 2 karyawan agar terlihat oleh departemen/pengguna tertentu. ID departemen dari Departemen Uji 1 adalah 1 dan ID departemen dari Departemen Uji 2 adalah 2.  Saat memanggil API ini, nilai dept\_permits yang diperoleh adalah \[1,2]. Daftar karyawan tidak dikembalikan, yaitu informasi Karyawan Xiaoding 1 dan Karyawan Xiaoding 2 tidak dikembalikan. - **Penyembunyian departemen ini tidak diaktifkan** (yaitu hide\_dept bernilai false): Bidang dept\_permits tidak dikembalikan.                                                                                                                                                                                   |
| auto\_approve\_apply        | Boolean         | true               | Apakah menerima permintaan untuk bergabung ke departemen ini secara default:   - **true:** Permintaan untuk bergabung ke departemen ini diterima secara default. - **false:** Permintaan untuk bergabung ke departemen ini memerlukan persetujuan dari admin yang memiliki izin.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| code                        | String          | 10000              | Kode departemen.  **Catatan**  Bidang ini dikembalikan hanya setelah kode departemen diatur melalui API [Memperbarui departemen](/id/open/development/address-book-update-department).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| member\_count               | Number          | 10                 | Jumlah karyawan di departemen (termasuk sub-departemen).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| owning\_member\_count       | Number          | 8                  | Jumlah karyawan yang secara langsung berada di departemen (tidak termasuk sub-departemen).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| union\_dept\_ext            | Object          |                    | Informasi departemen yang terkait.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| deptId                      | Number          | 1234567            | ID departemen yang terkait.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| corpId                      | String          | test               | ID organisasi dari departemen yang terkait.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "errmsg": "ok",
  "result": {
    "dept_permits": [
      3,
      4,
      5
    ],
    "outer_permit_users": [
      "user123",
      "1234"
    ],
    "dept_manager_userid_list": [
      "1020302901-431772414"
    ],
    "org_dept_owner": "manager9153",
    "outer_dept": false,
    "dept_group_chat_id": "chat1fccdb4b921f2bde18c26xxxx",
    "group_contain_sub_dept": true,
    "auto_add_user": true,
    "hide_dept": false,
    "name": "Test",
    "outer_permit_depts": [
      500,
      600
    ],
    "user_permits": [],
    "dept_id": 1,
    "create_dept_group": true,
    "order": 0,
    "code":"100",
    "union_dept_ext":{
      "corp_id": "test",
      "dept_id": 1234567
    }
  },
  "request_id": "4e7ljtq91rgo"
}
```

### Kode error

Jika terjadi error saat memanggil API ini, temukan solusinya berdasarkan pesan error di dokumen [Kode error global](/id/open/development/server-api-error-codes-1).

| Kode error (errcode) | Pesan error (errmsg)               | Solusi                                          |
| -------------------- | ---------------------------------- | ----------------------------------------------- |
| 43007                | Authorization required             | Pastikan access\_token memiliki izin operasi.   |
| 60003                | Corresponding department not found | Pastikan dept\_id sudah benar.                  |
| 400002               | Invalid parameter                  | Pastikan parameter dimasukkan sesuai ketentuan. |
| -1                   | System busy                        | Coba lagi nanti.                                |