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

# Kueri informasi grup absensi berdasarkan groupKey

> Panggil API DingTalk ini dengan groupKey untuk mengambil informasi grup absensi: jangkauan absen, izin absensi lapangan, dan kebutuhan persetujuan.

API ini mengueri informasi grup absensi berdasarkan groupKey grup absensi, termasuk jangkauan absen, apakah absensi lapangan diizinkan, dan apakah absensi lapangan memerlukan persetujuan.

## Permintaan

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

### Parameter kueri

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| access\_token | String | Ya | 4c9ebd2b1534xxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini. Dapatkan dengan memanggil [Mendapatkan access\_token Aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token). |

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| op\_userid | String | Tidak | user123 | ID pengguna operator. |
| group\_key | String | Ya | 02B1Exxxx | groupKey grup absensi.  **Catatan**  Jika pengidentifikasi grup absensi Anda adalah group\_id, panggil [Konversi groupId ke groupKey](https://help.dingtalk.io/id/open/development/groupid-to-groupkey.md) untuk mengonversi group\_id menjadi group\_key. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/group/get" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=9d319xxxx6e5f0' \
-d 'group_key=0151E0xxxx2A1A917' \
-d 'op_userid=123456'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/group/get");
OapiAttendanceGroupGetRequest req = new OapiAttendanceGroupGetRequest();
req.setOpUserid("123456");
req.setGroupKey("0151E022xxxxx1A917");
OapiAttendanceGroupGetResponse 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.OapiAttendanceGroupGetRequest("https://api.dingtalk.io/topapi/attendance/group/get")

req.op_userid="123456"
req.group_key="0151E02xxxxA1A917"
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 OapiAttendanceGroupGetRequest;
$req->setOpUserid("123456");
$req->setGroupKey("0151Exxxx1A917");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/group/get");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/group/get");
OapiAttendanceGroupGetRequest req = new OapiAttendanceGroupGetRequest();
req.OpUserid = "123456";
req.GroupKey = "0151E0xxxxA1A917";
OapiAttendanceGroupGetResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | Object | | Hasil informasi grup absensi. |
| name | String | Grup absensi uji 1 | Nama grup absensi. |
| ext | String | | Bidang ekstensi dalam format JSON. |
| location\_offset | Number | 100 | Jangkauan absen, dalam meter.  **Catatan**  Bidang ini tidak digunakan lagi. Gunakan offset yang dikembalikan oleh [Kueri lokasi secara massal](https://help.dingtalk.io/id/open/development/batch-query-position-under-attendance-group.md) sebagai gantinya. |
| group\_key | String | 0151E0223B1EDDDF00DD6B7F72A1A917 | groupKey grup absensi. |
| enable\_face\_check | Boolean | false | Apakah absen dengan senyum diaktifkan.   - **true**: Aktif - **false** (default): Nonaktif |
| enable\_face\_beauty | Boolean | false | Apakah filter kecantikan diaktifkan.   - **true**: Aktif - **false** (default): Nonaktif |
| enable\_camera\_check | Boolean | false | Apakah absen dengan foto diaktifkan.   - **true**: Aktif - **false** (default): Nonaktif |
| enable\_outside\_check | Boolean | false | Apakah absensi lapangan diizinkan.   - **true**: Diizinkan - **false** (default): Tidak diizinkan |
| enable\_outside\_apply | Boolean | false | Apakah absensi lapangan memerlukan persetujuan.   - **true**: Wajib - **false** (default): Tidak wajib |
| outside\_check\_approve\_mode | Number | 0 | Mode persetujuan untuk absensi lapangan.   - **-1** (default): Nonaktif - **0**: Setujui terlebih dahulu, lalu absen - **1**: Absen terlebih dahulu, lalu setujui |
| enable\_outside\_remark | Boolean | false | Apakah absensi lapangan memerlukan keterangan.   - **true**: Wajib - **false** (default): Tidak wajib |
| enable\_outside\_camera\_check | Boolean | false | Apakah absensi lapangan memerlukan keterangan foto.   - **true**: Wajib - **false** (default): Tidak wajib |
| forbid\_hide\_outside\_address | Boolean | true | Apakah karyawan dilarang menyembunyikan alamat detail.   - **true** (default): Dilarang - **false**: Tidak dilarang |
| enable\_outside\_update\_normal\_check | Boolean | false | Apakah catatan absensi lapangan dapat memperbarui catatan absen reguler.   - **true**: Diizinkan - **false** (default): Tidak diizinkan |
| enable\_trim\_distance | Boolean | false | Apakah penyesuaian halus jarak lokasi diizinkan.   - **true**: Diizinkan - **false** (default): Tidak diizinkan |
| trim\_distance | Number | 50 | Jangkauan penyesuaian halus lokasi, dalam meter. |
| errmsg | String | ok | Pesan error yang dikembalikan. |
| success | Boolean | true | Apakah permintaan berhasil.   - **true**: Berhasil - **false**: Gagal |
| errcode | Number | 0 | Kode error. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "result":{
    "ext":"",
    "enable_camera_check":false,
    "enable_face_beauty":false,
    "outside_check_approve_mode":0,
    "forbid_hide_outside_address":true,
    "enable_face_check":false,
    "enable_outside_apply":false,
    "enable_outside_camera_check":false,
    "enable_outside_update_normal_check":false,
    "trim_distance":50,
    "enable_outside_check":false,
    "location_offset":100,
    "enable_outside_remark":false,
    "name":"Grup absensi uji 1",
    "group_key":"0151E0223B1EDDDF00DD6B7F72A1A917",
    "enable_trim_distance":false
  },
  "errcode":0,
  "success":true,
  "errmsg":"ok"
}
```

### Kode error

Jika 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.