> ## 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 hasil absen penjadwalan shift

> Gunakan API DingTalk ini untuk mengkueri hasil absen penjadwalan shift secara massal berdasarkan ID jadwal, lengkap dengan tipe absensi dan waktu absen terencana.

Panggil API ini untuk mengkueri hasil absen penjadwalan shift berdasarkan ID jadwal serta mendapatkan tipe absensi, waktu absen terencana, waktu modifikasi terakhir, dan informasi lainnya.

## Permintaan

| **Informasi Dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/schedule/result/listbyids](https://api.dingtalk.io/topapi/attendance/schedule/result/listbyids) |
| 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 | bE74xxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini.   - Untuk Aplikasi internal, dapatkan dengan memanggil API [Mendapatkan access\_token Aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token). - Untuk Aplikasi perusahaan pihak ketiga, dapatkan dengan memanggil API Mendapatkan access\_token Aplikasi perusahaan pihak ketiga. |

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| op\_user\_id | String | Ya | manager123 | userId operator. |
| schedule\_ids | String | Ya | 144872188723,144872188722 | ID jadwal. Panggil API [Kueri detail penjadwalan shift absensi organisasi](https://help.dingtalk.io/id/open/development/interface-for-daily-full-query-of-attendance-scheduling-information.md) untuk mendapatkan nilai parameter plan\_id. Pisahkan beberapa ID jadwal dengan koma. Setiap panggilan mendukung hingga 100 ID jadwal. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/schedule/result/listbyids" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=711cexxxx8ce772' \
-d 'op_user_id=dd_dd' \
-d 'schedule_ids=1234%2C3214'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/schedule/result/listbyids");
OapiAttendanceScheduleResultListbyidsRequest req = new OapiAttendanceScheduleResultListbyidsRequest();
req.setOpUserId("user456");
req.setScheduleIds("16xxxx530,160xxxx12");
OapiAttendanceScheduleResultListbyidsResponse 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.OapiAttendanceScheduleResultListbyidsRequest("https://api.dingtalk.io/topapi/attendance/schedule/result/listbyids")

req.op_user_id="dd_dd"
req.schedule_ids="[1234,3214]"
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 OapiAttendanceScheduleResultListbyidsRequest;
$req->setOpUserId("dd_dd");
$req->setScheduleIds("[1234,3214]");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/schedule/result/listbyids");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/schedule/result/listbyids");
OapiAttendanceScheduleResultListbyidsRequest req = new OapiAttendanceScheduleResultListbyidsRequest();
req.OpUserId = "dd_dd";
req.ScheduleIds = "1234,3214";
OapiAttendanceScheduleResultListbyidsResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | TopScheduleResultVo\[] | demo | Hasil kueri. |
| check\_type | String | OnDuty | Tipe absensi:   - **Onduty**: Absen masuk - **OffDuty**: Absen pulang |
| gmt\_modified | Date | 2020-11-11 19:03:21 | Waktu modifikasi terakhir. |
| plan\_check\_time | Date | 2020-11-11 19:03:20 | Waktu absen terencana. |
| corp\_id | String | dingxxxxx1c1 | ID organisasi. |
| base\_check\_time | Date | 2020-11-11 19:03:00 | Waktu absen terencana setelah disesuaikan dengan aturan seperti toleransi keterlambatan dan pulang lebih awal. |
| group\_id | Number | 67xxxx4 | ID grup absensi. |
| gmt\_create | Date | 2020-11-11 19:03:21 | Waktu pembuatan. |
| user\_id | String | user123 | userId pengguna. |
| work\_date | Date | 2020-11-11 00:00:00 | Hari kerja, yaitu tanggal spesifik jadwal tersebut. |
| id | Number | 11xxxx19 | ID hasil absen. |
| location\_result | String | Normal | Hasil lokasi absen:   - **Normal**: Absen normal - **NotSigned**: Belum absen - **Outside**: Kerja lapangan |
| is\_legal | String | Y | Menunjukkan apakah absen mengalami error:   - **N**: Tidak - **Y**: Ya |
| time\_result | String | Normal | Hasil waktu absen:   - **Normal**: Absen normal - **NotSigned**: Belum absen - **Late**: Keterlambatan - **SeriousLate**: Keterlambatan serius - **Absenteeism**: Mangkir karena keterlambatan - **Early**: Pulang lebih awal |
| record\_id | Number | 48xxxx644 | Catatan absen. |
| user\_check\_time | Date | 2020-11-11 19:03:20 | Waktu absen. |
| schedule\_id | Number | 5672xxxx63 | ID jadwal. |
| success | Boolean | true | Menunjukkan apakah permintaan berhasil.   - **true**: Berhasil - **false**: Gagal |
| errcode | Number | 0 | Kode pengembalian. |
| errmsg | String | ok | Deskripsi kode pengembalian. |
| request\_id | String | 6k9c3cvix353 | ID permintaan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "errmsg":"ok",
  "result": [
    {
      "base_check_time": "2020-11-11 19:03:00",
      "check_type": "OnDuty",
      "corp_id": "dingxxxxx1c1",
      "gmt_create": "2020-11-11 19:03:21",
      "gmt_modified": "2020-11-11 19:03:21",
      "group_id": 67xxxx4,
      "id": 11xxxx19,
      "is_legal": "Y",
      "location_result": "Normal",
      "plan_check_time": "2020-11-11 19:03:20",
      "record_id": 48xxxx644,
      "schedule_id": 16xxxx812,
      "time_result": "Normal",
      "user_check_time": "2020-11-11 19:03:20",
      "user_id": "user456",
      "work_date": "2020-11-11 00:00:00"
    }
  ],
  "success": true,
  "request_id": "6k9c3cvix353"
}
```

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


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