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

# Dapatkan data cuti dari laporan absensi

> Panggil API DingTalk untuk mengambil data kolom cuti dari laporan absensi cerdas berdasarkan ID pengguna dan nama cuti dalam periode waktu tertentu.

Panggil API ini untuk mendapatkan data cuti dari laporan absensi cerdas DingTalk berdasarkan nama cuti dan ID pengguna. Data yang dikembalikan mencakup semua nilai di kolom cuti laporan dalam periode waktu tertentu. Kolom cuti bersifat dinamis, sehingga Anda wajib menentukan nama cuti untuk mendapatkan datanya.

## Deskripsi panggilan API

Untuk kemampuan akses dan pemanfaatan data lainnya, buka Data Asset Platform. Data Asset Platform (dPaaS) adalah platform pengelolaan data terpadu untuk organisasi. Dibangun di atas DingTalk, platform ini menyediakan layanan data yang aman, skalabel, dan mudah dipelihara untuk mendukung pengambilan keputusan bisnis.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/getleavetimebynames](https://api.dingtalk.io/topapi/attendance/getleavetimebynames) |
| 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 query

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

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| userid | String | Ya | manager123 | ID pengguna dari pengguna. |
| leave\_names | String | Ya | Cuti tahunan | Nama cuti. Pisahkan beberapa nama dengan koma. Panjang maksimum: 20. |
| from\_date | Date | Ya | 2020-09-09 12:12:12 | Waktu mulai. Data yang lebih lama dari 225 hari tidak didukung. |
| to\_date | Date | Ya | 2020-09-11 12:12:12 | Waktu selesai. Selang antara waktu mulai dan waktu selesai harus dalam 31 hari. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/getleavetimebynames" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=1b8b85xxxxx3ccfdd' \
-d 'from_date=2018-07-11+12%3A12%3A12' \
-d 'leave_names=Cuti+tahunan' \
-d 'to_date=2018-07-11+12%3A12%3A12' \
-d 'userid=zhangsan'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/getleavetimebynames");
OapiAttendanceGetleavetimebynamesRequest req = new OapiAttendanceGetleavetimebynamesRequest();
req.setUserid("zhangsan");
req.setLeaveNames("Cuti tahunan");
req.setFromDate(StringUtils.parseDateTime("2020-09-01 00:00:00"));
req.setToDate(StringUtils.parseDateTime("2020-09-30 00:00:00"));
OapiAttendanceGetleavetimebynamesResponse 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.OapiAttendanceGetleavetimebynamesRequest("https://api.dingtalk.io/topapi/attendance/getleavetimebynames")

req.userid="zhangsan"
req.leave_names="Cuti tahunan"
req.from_date="2018-07-11 12:12:12"
req.to_date="2018-07-11 12:12: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 OapiAttendanceGetleavetimebynamesRequest;
$req->setUserid("zhangsan");
$req->setLeaveNames("Cuti tahunan");
$req->setFromDate("2018-07-11 12:12:12");
$req->setToDate("2018-07-11 12:12:12");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/getleavetimebynames");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/getleavetimebynames");
OapiAttendanceGetleavetimebynamesRequest req = new OapiAttendanceGetleavetimebynamesRequest();
req.Userid = "zhangsan";
req.LeaveNames = "Cuti tahunan";
req.FromDate = DateTime.Parse("2018-07-11 12:12:12");
req.ToDate = DateTime.Parse("2018-07-11 12:12:12");
OapiAttendanceGetleavetimebynamesResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | ColumnValListForTopVo | | Hasil yang dikembalikan. |
| columns | ColumnValForTopVo\[] | | Informasi kolom dan data nilai kolom. |
| columnvo | ColumnForTopVo | | Informasi kolom. |
| name | String | Cuti pribadi | Nama cuti. |
| sub\_type | Number | 0 | Subtipe. |
| status | Number | 0 | Status kolom. |
| alias | String | leave\_ | Alias. |
| type | Number | 0 | Tipe kolom. |
| columnvals | ColumnDayAndVal\[] | | Data nilai kolom. |
| value | String | 1.0 | Nilai harian. |
| date | Date | 2020-09-09 12:12:12 | Waktu mulai. |
| errcode | Number | 0 | Kode pengembalian. |
| request\_id | String | whv0fhtk8cnc | ID permintaan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "result": {
    "columns": [
      {
        "columnvals": [
          {
            "date": "2020-09-01 00:00:00",
            "value": "0.0"
          },
          {
            "date": "2020-09-02 00:00:00",
            "value": "0.0"                   
          }
        ],
        "columnvo": {
          "alias": "leave_",
          "name": "Cuti pribadi",
          "status": 0,
          "sub_type": 0,
          "type": 0
        }
      }
    ]
  },
  "request_id": "whv0fhtk8cnc"
}
```

### Kode kesalahan

Jika panggilan ke 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 yang diterima.


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