> ## 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 grup absensi

> Panggil API DingTalk ini untuk mengambil detail grup absensi berdasarkan ID, termasuk nama grup, pemilik utama, dan tipe absensi untuk integrasi sistem HR Anda.

Panggil API ini untuk mendapatkan detail grup absensi berdasarkan ID grup absensi, seperti nama grup absensi, pemilik utama grup absensi, dan tipe absensi.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/group/query](https://api.dingtalk.io/topapi/attendance/group/query) |
| Metode HTTP | POST |
| Tipe aplikasi yang didukung | appType-Aplikasi internal　appType-Aplikasi perusahaan pihak ketiga |
| Izin yang diperlukan | permission-qyapi\_attendance\_group\_read-Izin kueri grup absensi |

### Parameter kueri

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| access\_token | String | Ya | bE74xxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini.   - Untuk Aplikasi internal, panggil API [Mendapatkan access\_token Aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token) untuk memperolehnya. - Untuk Aplikasi perusahaan pihak ketiga, panggil API Mendapatkan access\_token Aplikasi perusahaan pihak ketiga untuk memperolehnya. |

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| op\_user\_id | String | Ya | user123 | userId operator. |
| group\_id | Number | Ya | 685935028 | ID grup absensi. Panggil API [Mendapatkan detail grup absensi secara massal](https://help.dingtalk.io/id/open/development/batch-obtain-attendance-group-details.md) untuk memperoleh nilai group\_id.  **Catatan**  Jika Anda memiliki pengenal grup absensi lama (group\_key), panggil API [Mengonversi groupKey menjadi groupId](https://help.dingtalk.io/id/open/development/convert-groupkey-to-groupid.md) untuk mengonversi group\_key menjadi group\_id. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/group/query" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=65671xxxx92ddf0' \
-d 'group_id=23456' \
-d 'op_user_id=dd_dd'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/group/query");
OapiAttendanceGroupQueryRequest req = new OapiAttendanceGroupQueryRequest();
req.setOpUserId("dd_dd");
req.setGroupId(23456L);
OapiAttendanceGroupQueryResponse 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.OapiAttendanceGroupQueryRequest("https://api.dingtalk.io/topapi/attendance/group/query")

req.op_user_id="dd_dd"
req.group_id=23456
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 OapiAttendanceGroupQueryRequest;
$req->setOpUserId("dd_dd");
$req->setGroupId("23456");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/group/query");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/group/query");
OapiAttendanceGroupQueryRequest req = new OapiAttendanceGroupQueryRequest();
req.OpUserId = "dd_dd";
req.GroupId = 23456L;
OapiAttendanceGroupQueryResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | TopSimpleGroupVO | | Hasil yang dikembalikan. |
| name | String | Absensi | Nama grup absensi. |
| shift\_ids | Number\[] | \[677995086] | ID shift. |
| id | Number | 685935028 | ID grup absensi. |
| wifis | String\[] | \["test-inc"] | Nama Wi-Fi. |
| address\_list | String\[] | \["Lahan Basah Xixi"] | Alamat absensi. |
| work\_day\_list | Number\[] | \[0,1,2,3] | Hari kerja. |
| member\_count | Number | 39 | Jumlah pengguna. |
| type | String | TURN | Tipe grup absensi.   - **FIXED:** Grup absensi shift tetap - **TURN:** Grup absensi berbasis shift - **NONE:** Grup absensi jam kerja fleksibel |
| url | String | [https://attend.dingtalk.io/xxxx](https://attend.dingtalk.io/xxxx) | Tautan pengalihan. |
| manager\_list | String | user456 | Admin grup absensi. |
| owner\_user\_id | String | user01 | userId pemilik utama grup absensi. |
| success | Boolean | true | Menunjukkan apakah permintaan berhasil.   - **true**: Berhasil - **false**: Gagal |
| errcode | Number | 0 | Kode pengembalian. |
| request\_id | String | 72hycvnsyykp | ID permintaan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "result": {
    "address_list": [
      "Lahan Basah Xixi"
    ],
    "id": 685935028,
    "manager_list": "[user456]",
    "member_count": 1,
    "name": "Absensi",
    "owner_user_id": "user01",
    "shift_ids": [
      677995086
    ],
    "type": "TURN",
    "url": "https://attend.dingtalk.io/xxxx",
    "wifis": [
      "test-inc"
    ],
    "work_day_list": [
      0,
      677995086,
      677995086,
      677995086,
      677995086,
      678215070,
      0
    ]
  },
  "success": true,
  "request_id": "lps4czm0g3qu"
}
```

### Kode error

Jika panggilan API ini mengembalikan error, cari solusinya di dokumen [Kode error global](https://help.dingtalk.io/id/open/development/server-api-error-codes-1.md) berdasarkan pesan error.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.