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

# Mengkueri informasi penjadwalan shift pengguna

> Panggil API DingTalk ini untuk mengkueri jadwal shift, status absen, dan grup absensi pengguna pada hari tertentu berdasarkan userId dan Unix timestamp milidetik.

Panggil API ini untuk mengkueri informasi penjadwalan shift pengguna pada hari tertentu.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/schedule/listbyday](https://api.dingtalk.io/topapi/attendance/schedule/listbyday) |
| Metode HTTP | POST |
| Tipe aplikasi yang didukung | appType-Aplikasi internal　appType-Aplikasi perusahaan pihak ketiga |
| Izin | qyapi\_attendance\_group\_read (izin baca grup absensi) |

### Parameter kueri

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

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| op\_user\_id | String | Ya | manager123 | userId operator. |
| user\_id | String | Ya | dd\_dd | userId pengguna yang akan dikueri. |
| date\_time | Number | Ya | 1564145519000 | Tanggal yang akan dikueri, dalam format Unix timestamp milidetik. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/schedule/listbyday" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=5d7f91f3-e22c-41ca-aee3-aa008603e00b' \
-d 'date_time=1564145519000' \
-d 'op_user_id=dd_dd' \
-d 'user_id=dd_dd'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/schedule/listbyday");
OapiAttendanceScheduleListbydayRequest req = new OapiAttendanceScheduleListbydayRequest();
req.setOpUserId("user123");
req.setUserId("user456");
req.setDateTime(1564145519000L);
OapiAttendanceScheduleListbydayResponse 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.OapiAttendanceScheduleListbydayRequest("https://api.dingtalk.io/topapi/attendance/schedule/listbyday")

req.op_user_id="dd_dd"
req.user_id="dd_dd"
req.date_time=1564145519000
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 OapiAttendanceScheduleListbydayRequest;
$req->setOpUserId("dd_dd");
$req->setUserId("dd_dd");
$req->setDateTime("1564145519000");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/schedule/listbyday");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/schedule/listbyday");
OapiAttendanceScheduleListbydayRequest req = new OapiAttendanceScheduleListbydayRequest();
req.OpUserId = "dd_dd";
req.UserId = "dd_dd";
req.DateTime = 1564145519000L;
OapiAttendanceScheduleListbydayResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | TopScheduleVo\[] | | Hasil kueri. |
| check\_type | String | OnDuty | Tipe absensi:   - **Onduty**: Absen masuk kerja - **OffDuty**: Absen pulang kerja |
| approve\_type | String | demo | Tipe persetujuan.  **Catatan**  Bidang ini tidak dikembalikan jika tidak ada formulir persetujuan pada hari tersebut. |
| gmt\_modified | Date | 2020-11-10 14:33:13 | Waktu modifikasi terakhir. |
| gmt\_create | Date | 2020-10-26 03:26:59 | Waktu pembuatan. |
| corp\_id | String | dinge8xxxx | ID organisasi (corpId). Lihat di halaman Beranda [Developer Console](https://open-dev.dingtalk.io/). |
| check\_date\_time | Date | 2020-11-10 14:33:13 | Waktu absen karyawan. |
| group\_id | Number | 394775001 | ID grup absensi. |
| class\_name | String | dsdsd | Nama shift. |
| user\_id | String | dd\_test | userId pengguna. |
| approve\_biz\_type | Number | demo | Tipe persetujuan cuti dan absensi yang terikat pada penjadwalan shift:   - **1**: Lembur - **2**: Perjalanan dinas - **3**: Cuti   **Catatan**  Bidang ini tidak dikembalikan jika tidak ada formulir persetujuan pada hari tersebut. |
| approve\_id | Number | 123 | ID formulir persetujuan yang terikat pada penjadwalan shift.  **Catatan**  Bidang ini tidak dikembalikan jika tidak ada formulir persetujuan pada hari tersebut. |
| class\_setting\_id | Number | 297490031 | ID pengaturan shift yang terkait dengan penjadwalan shift.  **Catatan**  Bidang ini tidak dikembalikan jika menggunakan pengaturan global. |
| approve\_tag\_name | String | Cuti | Nama formulir persetujuan cuti dan absensi yang terikat pada penjadwalan shift.  **Catatan**  Bidang ini tidak dikembalikan jika tidak ada formulir persetujuan pada hari tersebut. |
| features | String | `{\"dataSource\":\"adminSetting\",\"flexMinutes\":[60,60],\"overtimeSettingId\":221375127,\"punchId\":524588947}` | Bidang tambahan.   - **dataSource**: Bidang ini saat ini tidak memiliki makna praktis. - **flexMinutes**: Waktu fleksibel yang diizinkan oleh pengaturan shift untuk datang terlambat dan pulang terlambat, atau datang lebih awal dan pulang lebih awal, dalam satuan menit. - **punchId**: ID titik absen yang terkait. - **overtimeSettingId**: ID aturan lembur. |
| class\_id | Number | 370370019 | ID shift. |
| check\_status | String | Timeout | Status absen:   - **Init**: Belum absen - **Checked**: Sudah absen - **Timeout**: Absen terlewat |
| work\_date | Date | 2020-11-10 00:00:00 | Hari kerja, menunjukkan hari spesifik penjadwalan shift. |
| check\_end\_time | Date | 2020-09-08 09:30:00 | Waktu berakhir rentang absen. |
| is\_rest | String | N | Apakah hari tersebut merupakan hari libur:   - **Y**: Dijadwalkan sebagai hari libur - **N**: Bukan hari libur |
| check\_begin\_time | Date | 2020-09-08 09:00:00 | Waktu mulai rentang absen. |
| real\_plan\_time | Date | 2020-09-08 10:00:00 | Waktu pengguna seharusnya absen setelah penyesuaian jam kerja fleksibel diaktifkan untuk titik absen. |
| id | Number | 56676915454 | ID penjadwalan shift. |
| success | Boolean | true | Menunjukkan apakah permintaan berhasil.   - **true**: Berhasil - **false**: Gagal |
| errcode | Number | 0 | Kode pengembalian. |
| errmsg | String | demo | Deskripsi kode pengembalian. |
| request\_id | String | 6bzhf2vn89pv | ID permintaan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "result": [
    {
      "check_date_time": "2020-11-10 09:30:00",
      "check_status": "Timeout",
      "check_type": "OnDuty",
      "class_id": 677995086,
      "class_name": "A",
      "class_setting_id": 599315627,
      "corp_id": "dinge8xxxx",
      "features": "{\"flexMinutes\":[30,30],\"overtimeSettingId\":581490201,\"punchId\":346266563}",
      "gmt_create": "2020-10-26 03:26:59",
      "gmt_modified": "2020-11-10 14:33:13",
      "group_id": 685935028,
      "id": 156270023005,
      "is_rest": "N",
      "real_plan_time": "2020-11-10 09:30:00",
      "user_id": "user123",
      "work_date": "2020-11-10 00:00:00"
    },
    {
      "check_date_time": "2020-11-10 18:30:00",
      "check_status": "Timeout",
      "check_type": "OffDuty",
      "class_id": 677995086,
      "class_name": "A",
      "class_setting_id": 599315627,
      "corp_id": "dinge8xxxx",
      "features": "{\"flexMinutes\":[30,30],\"overtimeSettingId\":581490201,\"punchId\":346266564}",
      "gmt_create": "2020-10-26 03:26:59",
      "gmt_modified": "2020-11-11 02:30:45",
      "group_id": 685935028,
      "id": 156270023006,
      "is_rest": "N",
      "real_plan_time": "2020-11-10 18:30:00",
      "user_id": "user123",
      "work_date": "2020-11-10 00:00:00"
    }
  ],
  "success": true,
  "request_id": "6bzhf2vn89pv"
}
```

### Kode error

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