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

> Panggil API ini untuk mendapatkan informasi dasar subdepartemen langsung di bawah departemen tertentu di DingTalk; pengambilan rekursif semua tingkat subdepartemen tidak didukung.

Panggil API ini untuk mendapatkan informasi dasar departemen tingkat berikutnya. API ini hanya mengembalikan informasi dasar subdepartemen langsung dari departemen saat ini. API ini tidak mengembalikan semua subdepartemen di setiap tingkat.

## Permintaan

| **Informasi dasar**         |                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------ |
| URL HTTP                    | [https://api.dingtalk.io/topapi/v2/department/listsub](https://api.dingtalk.io/topapi/v2/department/listsub) |
| Metode HTTP                 | POST                                                                                                         |
| Tipe aplikasi yang didukung | appType-Aplikasi internalappType-Aplikasi perusahaan pihak ketiga                                            |
| Izin                        | permission-qyapi\_get\_department\_list-Izin baca untuk informasi departemen di 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 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 | Tidak | 1      | ID departemen induk. Panggil API [Mendapatkan daftar departemen](#) untuk mendapatkan nilai parameter dept\_id. |
| language | String | Tidak | zh\_CN | Bahasa Kontak:   - **zh\_CN** (default): Bahasa Tionghoa - **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/listsub" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=6846xxxx0cc781' \
-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/listsub");
OapiV2DepartmentListsubRequest req = new OapiV2DepartmentListsubRequest();
req.setDeptId(1L);
req.setLanguage("zh_CN");
OapiV2DepartmentListsubResponse 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.OapiV2DepartmentListsubRequest("https://api.dingtalk.io/topapi/v2/department/listsub")

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

C#

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

## Respons

### Isi respons

| Nama                | Tipe                | Contoh                | Deskripsi                                                                                                                                                                                  |
| ------------------- | ------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| request\_id         | String              | 5um7ykyaalsj          | ID permintaan.                                                                                                                                                                             |
| errcode             | Number              | 0                     | Kode pengembalian.                                                                                                                                                                         |
| errmsg              | String              | Invalid access\_token | Pesan error yang dikembalikan ketika panggilan gagal.                                                                                                                                      |
| result              | DeptBaseResponse\[] |                       | Daftar departemen.                                                                                                                                                                         |
| dept\_id            | Number              | 100                   | ID departemen.                                                                                                                                                                             |
| name                | String              | HR                    | Nama departemen.                                                                                                                                                                           |
| parent\_id          | Number              | 50                    | ID departemen induk.                                                                                                                                                                       |
| create\_dept\_group | Boolean             | true                  | Apakah akan membuat obrolan organisasi yang terkait dengan departemen ini secara bersamaan:   - **true**: Buat - **false**: Jangan buat                                                    |
| auto\_add\_user     | Boolean             | false                 | Setelah Obrolan Departemen dibuat, apakah anggota baru yang bergabung dengan departemen otomatis ditambahkan ke obrolan:   - **true**: Ditambahkan otomatis - **false**: Tidak ditambahkan |

### Contoh respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "errmsg":"ok",
  "result": [
    {
      "auto_add_user": true,
      "create_dept_group": true,
      "dept_id": 37xxxx95,
      "name": "Departemen Pemasaran",
      "parent_id": 1
    },
    {
      "auto_add_user": true,
      "create_dept_group": true,
      "dept_id": 399xxxx96,
      "name": "Departemen Keuangan",
      "parent_id": 1
    }
  ],
  "request_id": "5um7ykyaalsj"
}
```

### Kode error

Jika panggilan API mengembalikan error, 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                                          |
| -------------------- | -------------------- | ----------------------------------------------- |
| 60003                | Department not found | Pastikan dept\_id sudah benar.                  |
| 400002               | Invalid parameter    | Pastikan parameter dimasukkan sesuai ketentuan. |
| -1                   | System busy          | Coba lagi nanti.                                |