> ## 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 definisi kolom laporan absensi

> Panggil API DingTalk ini untuk mendapatkan definisi kolom laporan absensi cerdas, termasuk ID, tipe, dan nama kolom, guna memilih kolom untuk perhitungan penggajian.

Panggil API ini untuk mengkueri statistik kolom dalam laporan absensi cerdas berdasarkan ID kolom. Organisasi dapat memilih nilai kolom yang digunakan dalam perhitungan penggajian.

## Deskripsi panggilan API

* API ini tidak mengembalikan ID untuk bidang terkait cuti. Untuk mendapatkan data terkait cuti, panggil API [Mendapatkan data cuti laporan](https://help.dingtalk.io/id/open/development/obtains-the-holiday-data-from-the-smart-attendance-report.md).
* Pastikan fitur statistik cerdas sudah diaktifkan.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/getattcolumns](https://api.dingtalk.io/topapi/attendance/getattcolumns) |
| Metode HTTP | POST |
| Tipe aplikasi yang didukung | appType-Aplikasi internal　appType-Aplikasi perusahaan pihak ketiga |
| Izin yang diperlukan | permission-qyapi\_base-Izin dasar yang diperlukan untuk memanggil API organisasi |

### 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 [Mendapatkan access\_token Aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token). - Untuk Aplikasi perusahaan pihak ketiga, dapatkan melalui API Mendapatkan access\_token organisasi pihak ketiga. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/getattcolumns" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=1aae6dxxxx7bf36'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/getattcolumns");
OapiAttendanceGetattcolumnsRequest req = new OapiAttendanceGetattcolumnsRequest();
OapiAttendanceGetattcolumnsResponse 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.OapiAttendanceGetattcolumnsRequest("https://api.dingtalk.io/topapi/attendance/getattcolumns")

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 OapiAttendanceGetattcolumnsRequest;
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/getattcolumns");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/getattcolumns");
OapiAttendanceGetattcolumnsRequest req = new OapiAttendanceGetattcolumnsRequest();
OapiAttendanceGetattcolumnsResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| request\_id | String | emhw3318cdhv | ID permintaan. |
| errcode | Number | 0 | Kode pengembalian. |
| result | AttColumnsForTopVo | | Hasil kueri. |
| columns | ColumnForTopVo\[] | | Informasi kolom laporan. |
| id | Number | 123 | ID kolom laporan. |
| type | Number | 0 | Tipe kolom laporan. |
| name | String | Jam kerja | Nama kolom laporan. |
| alias | String | 3\_on\_duty\_user\_check\_result | Alias kolom laporan. |
| status | Number | 0 | Status kolom laporan. |
| sub\_type | Number | 0 | Subtipe. |
| expression\_id | Number | 129334038 | Bidang yang tidak digunakan lagi. Jangan gunakan bidang ini dalam logika bisnis. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "result": {
    "columns": [
      {
        "alias": "should_attendance_days",
        "expression_id": 129334038,
        "id": 129339038,
        "name": "Hari absensi wajib",
        "status": 0,
        "sub_type": 0,
        "type": 0
      },
      {
        "alias": "making_up_lack_times",
        "expression_id": 129334039,
        "id": 129339039,
        "name": "Jumlah absen susulan",
        "status": 0,
        "sub_type": 0,
        "type": 0
      }
    ]
  },
  "request_id": "10stq4mcre2wu"
}
```

### Kode error

Jika panggilan API ini gagal, 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.