> ## 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 semua departemen induk dari departemen tertentu

> Panggil API ini untuk mendapatkan daftar semua ID departemen induk dari departemen tertentu di DingTalk. API ini tidak dibatasi oleh cakupan izin Kontak.

Panggil API ini untuk mendapatkan daftar ID semua departemen induk dari departemen tertentu. API ini tidak dibatasi oleh cakupan izin Kontak.

## Permintaan

| **Informasi dasar**         |                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| URL HTTP                    | [https://api.dingtalk.io/topapi/v2/department/listparentbydept](https://api.dingtalk.io/topapi/v2/department/listparentbydept) |
| Metode HTTP                 | POST                                                                                                                           |
| Tipe aplikasi yang didukung | appType-Aplikasi internal, appType-Aplikasi perusahaan pihak ketiga                                                            |
| Izin yang diperlukan        | permission-qyapi\_get\_department\_list-Izin baca untuk informasi 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 untuk mendapatkan [access\_token aplikasi internal](/id/open/development/obtain-orgapp-token). - Untuk aplikasi perusahaan pihak ketiga, dapatkan melalui API untuk mendapatkan access\_token perusahaan pihak ketiga. |

### Isi permintaan

| Nama     | Tipe   | Wajib | Contoh   | Deskripsi                                                                                                                                                                         |
| -------- | ------ | ----- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| dept\_id | Number | Ya    | 42xxxx36 | ID departemen yang akan dikueri. Panggil API [Mendapatkan daftar departemen](/id/open/development/user-management-acquires-the-list-departments) untuk memperoleh nilai dept\_id. |

### Contoh permintaan

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

Java

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

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

C#

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

## Respons

### Isi respons

| Nama             | Tipe                           | Contoh                | Deskripsi                                                                                                                                                                                                                                                               |
| ---------------- | ------------------------------ | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| request\_id      | String                         | 10u9dj0853fwe         | ID permintaan.                                                                                                                                                                                                                                                          |
| errcode          | Number                         | 0                     | Kode pengembalian.                                                                                                                                                                                                                                                      |
| errmsg           | String                         | Invalid department ID | Pesan error yang dikembalikan saat panggilan gagal.                                                                                                                                                                                                                     |
| result           | DeptListParentByDeptIdResponse |                       | Daftar ID departemen induk.                                                                                                                                                                                                                                             |
| parent\_id\_list | Number\[]                      | \[789, 456, 123, 1]   | Daftar ID semua departemen induk dari departemen tersebut.  **Catatan**  Dalam daftar yang dikembalikan, elemen pertama adalah ID departemen saat ini, dan elemen terakhir adalah ID departemen induk tingkat teratas. Tingkat departemen meningkat dari kiri ke kanan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "errmsg": "ok",
  "result": {
    "parent_id_list": [
      42xxxx36,
      1
    ]
  },
  "request_id": "ov7bc964j9pe"
}
```

### Kode error

Jika terjadi error saat Anda memanggil API ini, lihat dokumen [Kode error global](/id/open/development/server-api-error-codes-1) untuk menemukan solusi berdasarkan pesan error.

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