> ## 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 detail penjadwalan shift absensi organisasi

> Panggil API DingTalk ini untuk mengambil data shift dan penjadwalan shift absensi seluruh karyawan organisasi Anda pada tanggal tertentu, lengkap dengan dukungan paginasi.

Panggil API ini untuk mengkueri informasi shift dan penjadwalan shift absensi seluruh karyawan di organisasi Anda pada hari tertentu.

## Deskripsi panggilan API

* Untuk absensi shift tetap, informasi penjadwalan shift hanya tersedia untuk 15 hari ke depan.
* API ini hanya tersedia untuk organisasi dengan jumlah anggota kurang dari 10.000.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/listschedule](https://api.dingtalk.io/topapi/attendance/listschedule) |
| 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 dengan memanggil [Mendapatkan access\_token aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token). - Untuk Aplikasi perusahaan pihak ketiga, dapatkan dengan memanggil Mendapatkan access\_token organisasi pihak ketiga. |

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| workDate | Date | Ya | 2020-09-06 | Tanggal penjadwalan shift. Hanya tahun, bulan, dan hari yang digunakan. |
| offset | Number | Tidak | 0 | Offset paginasi, dimulai dari 0. Hanya berlaku jika diatur bersama parameter size. |
| size | Number | Tidak | 200 | Ukuran halaman. Nilai maksimum: 200. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/listschedule" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=b9305xxxxea83' \
-d 'offset=0' \
-d 'size=200' \
-d 'workDate=2016-03-09+11%3A11%3A11'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/listschedule");
OapiAttendanceListscheduleRequest req = new OapiAttendanceListscheduleRequest();
req.setWorkDate(StringUtils.parseDateTime("2016-03-09 11:11:11"));
req.setOffset(0L);
req.setSize(200L);
OapiAttendanceListscheduleResponse 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.OapiAttendanceListscheduleRequest("https://api.dingtalk.io/topapi/attendance/listschedule")

req.workDate="2016-03-09 11:11:11"
req.offset=0
req.size=200
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 OapiAttendanceListscheduleRequest;
$req->setWorkDate("2016-03-09 11:11:11");
$req->setOffset("0");
$req->setSize("200");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/listschedule");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/listschedule");
OapiAttendanceListscheduleRequest req = new OapiAttendanceListscheduleRequest();
req.WorkDate = DateTime.Parse("2016-03-09 11:11:11");
req.Offset = 0L;
req.Size = 200L;
OapiAttendanceListscheduleResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | AtScheduleListForTopVo | | Hasil kueri. |
| schedules | AtScheduleForTopVo\[] | | Daftar jadwal. |
| plan\_id | Number | 157062792171 | ID penjadwalan shift. |
| check\_type | String | OnDuty | Tipe absen:   - **Onduty**: Absen masuk - **OffDuty**: Absen pulang |
| approve\_id | Number | 1 | ID persetujuan.  **Catatan**  Parameter ini tidak dikembalikan jika tidak ada formulir persetujuan. |
| userid | String | user01 | ID pengguna dari pengguna absensi. |
| class\_id | Number | 677995086 | ID shift absensi. |
| class\_setting\_id | Number | 599315627 | ID konfigurasi shift.  **Catatan**  Parameter ini tidak dikembalikan jika konfigurasi global digunakan. |
| plan\_check\_time | Date | 2020-11-11 09:30:00 | Waktu absen. |
| group\_id | Number | 685935028 | ID grup absensi. |
| changed\_check\_time | Date | 2020-09-06 15:36:04 | Waktu absen yang telah disesuaikan. |
| has\_more | Boolean | false | Menunjukkan apakah terdapat halaman berikutnya.   - **true**: Ya - **false**: Tidak |
| errmsg | String | ok | Deskripsi kode pengembalian. |
| errcode | Number | 0 | Kode pengembalian. |
| request\_id | String | 6ha75i2o99fj | ID permintaan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "errmsg":"ok",
  "result": {
    "has_more": false,
    "schedules": [
      {
        "check_type": "OnDuty",
        "class_id": 677995086,
        "class_setting_id": 599315627,
        "group_id": 685935028,
        "plan_check_time": "2020-11-11 09:30:00",
        "plan_id": 157062792171,
        "userid": "user01"
      },
      {
        "check_type": "OffDuty",
        "class_id": 677995086,
        "class_setting_id": 599315627,
        "group_id": 685935028,
        "plan_check_time": "2020-11-11 18:30:00",
        "plan_id": 157062792172,
        "userid": "user01"
      }
    ]
  },
  "request_id": "6ha75i2o99fj"
}
```

### Kode kesalahan

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


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