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

# Mengonversi groupId menjadi groupKey

> Gunakan API absensi DingTalk ini untuk mengonversi groupId grup absensi menjadi groupKey, pengenal yang diperlukan oleh grup absensi versi baru.

Panggil API ini untuk mengonversi groupId grup absensi menjadi groupKey. groupKey adalah bidang pengenal yang digunakan pada grup absensi versi baru. Beberapa grup absensi memerlukan groupKey sebagai parameter. Jika Anda hanya memiliki bidang groupId dari grup absensi, panggil API ini untuk memperoleh groupKey.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/groups/idtokey](https://api.dingtalk.io/topapi/attendance/groups/idtokey) |
| 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 | 6d1bxxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini.   - Untuk Aplikasi internal, peroleh dengan memanggil API [Memperoleh access\_token Aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token). - Untuk Aplikasi perusahaan pihak ketiga, peroleh dengan memanggil API Memperoleh access\_token Aplikasi perusahaan pihak ketiga. |

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| op\_user\_id | String | Tidak | user01 | userId operator. |
| group\_id | Number | Ya | 1586536 | ID grup absensi. Panggil API [Memperoleh detail grup absensi secara massal](https://help.dingtalk.io/id/open/development/batch-obtain-attendance-group-details.md) untuk memperoleh nilai group\_id. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/groups/idtokey" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=ea55fdxxxx64242a' \
-d 'group_id=12' \
-d 'op_user_id=123'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/groups/idtokey");
OapiAttendanceGroupsIdtokeyRequest req = new OapiAttendanceGroupsIdtokeyRequest();
req.setOpUserId("user01");
req.setGroupId(1586536L);
OapiAttendanceGroupsIdtokeyResponse 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.OapiAttendanceGroupsIdtokeyRequest("https://api.dingtalk.io/topapi/attendance/groups/idtokey")

req.op_user_id="123"
req.group_id=12
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 OapiAttendanceGroupsIdtokeyRequest;
$req->setOpUserId("123");
$req->setGroupId("12");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/groups/idtokey");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/groups/idtokey");
OapiAttendanceGroupsIdtokeyRequest req = new OapiAttendanceGroupsIdtokeyRequest();
req.OpUserId = "123";
req.GroupId = 12L;
OapiAttendanceGroupsIdtokeyResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | String | 0151E0223B1xxxx | ID grup absensi. |
| errcode | Number | 0 | Kode pengembalian. |
| errmsg | String | ok | Deskripsi kode pengembalian. |
| request\_id | String | 3yt2gu3zz0qi | ID permintaan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode":0,
  "result":0151E0223B1xxxx,
  "errmsg":"ok",
  "request_id":"3yt2gu3zz0qi"
}
```

### Kode kesalahan

Jika panggilan API ini mengembalikan Error, cari solusinya di dokumen [Kode kesalahan 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.