> ## 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 massal informasi penjadwalan shift pengguna

> Panggil API DingTalk ini untuk mengueri informasi penjadwalan shift banyak karyawan sekaligus berdasarkan daftar ID pengguna dan rentang tanggal tertentu.

Panggil API ini untuk mengueri informasi penjadwalan shift karyawan pada hari tertentu secara massal.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/schedule/listbyusers](https://api.dingtalk.io/topapi/attendance/schedule/listbyusers) |
| Metode HTTP | POST |
| Tipe aplikasi yang didukung | appType-Aplikasi internal　appType-Aplikasi perusahaan pihak ketiga |
| Izin yang diperlukan | 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 [Mendapatkan access\_token Aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token). - Untuk Aplikasi perusahaan pihak ketiga, dapatkan dengan memanggil API untuk mendapatkan access\_token organisasi pihak ketiga. |

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| op\_user\_id | String | Ya | user456 | ID pengguna operator. |
| userids | String | Ya | user123 | Daftar ID pengguna yang akan dikueri. Pisahkan beberapa ID pengguna dengan koma. Kirim maksimal 50 ID pengguna sekaligus. |
| from\_date\_time | Number | Ya | 1565591096000 | Tanggal mulai, dalam format Unix timestamp milidetik. **Catatan** - Selisih antara waktu mulai dan waktu selesai tidak boleh lebih dari 7 hari. - Waktu kueri harus berada dalam 180 hari terakhir. |
| to\_date\_time | Number | Ya | 1565591096000 | Tanggal selesai, dalam format Unix timestamp milidetik. **Catatan** - Selisih antara waktu mulai dan waktu selesai tidak boleh lebih dari 7 hari. - Waktu kueri harus berada dalam 180 hari terakhir. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/schedule/listbyusers" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=9ad3xxxx82a10' \
-d 'from_date_time=1565591096000' \
-d 'op_user_id=dd_dd' \
-d 'to_date_time=1565591096000' \
-d 'userids=dd_dd%2Cduogui'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/schedule/listbyusers");
OapiAttendanceScheduleListbyusersRequest req = new OapiAttendanceScheduleListbyusersRequest();
req.setOpUserId("user456");
req.setUserids("user123,user456");
req.setFromDateTime(1565591096000L);
req.setToDateTime(1565591096000L);
OapiAttendanceScheduleListbyusersResponse 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.OapiAttendanceScheduleListbyusersRequest("https://api.dingtalk.io/topapi/attendance/schedule/listbyusers")

req.op_user_id="dd_dd"
req.userids="dd_dd,duogui"
req.from_date_time=1565591096000
req.to_date_time=1565591096000
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 OapiAttendanceScheduleListbyusersRequest;
$req->setOpUserId("dd_dd");
$req->setUserids("dd_dd,duogui");
$req->setFromDateTime("1565591096000");
$req->setToDateTime("1565591096000");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/schedule/listbyusers");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/schedule/listbyusers");
OapiAttendanceScheduleListbyusersRequest req = new OapiAttendanceScheduleListbyusersRequest();
req.OpUserId = "dd_dd";
req.Userids = "dd_dd,duogui";
req.FromDateTime = 1565591096000L;
req.ToDateTime = 1565591096000L;
OapiAttendanceScheduleListbyusersResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| result | TopScheduleVo\[] | demo | Hasil kueri. |
| check\_type | String | OnDuty | Tipe absensi: - **Onduty**: Absen masuk saat mulai kerja - **OffDuty**: Absen pulang saat selesai kerja |
| plan\_check\_time | Date | 2021-01-14 09:00:00 | Waktu absen yang dijadwalkan. |
| group\_id | Number | 394775001 | ID grup absensi. |
| userid | String | user456 | ID pengguna. |
| approve\_id | Number | 1234 | ID formulir persetujuan yang terikat pada jadwal. **Catatan** Bidang ini tidak dikembalikan jika tidak ada formulir persetujuan pada hari tersebut. |
| work\_date | Date | 2021-01-14 00:00:00 | Hari kerja, yang menunjukkan hari spesifik dari jadwal. |
| id | Number | 56676915454 | ID jadwal. |
| shift\_version | Number | 588655171 | Versi shift. |
| shift\_id | Number | 677995086 | ID shift. Nilai 0 menunjukkan hari libur. |
| is\_rest | String | N | Menunjukkan apakah hari tersebut merupakan hari libur: - **Y**: Hari tersebut dijadwalkan sebagai hari libur - **N**: Hari tersebut bukan hari libur |
| success | Boolean | true | Menunjukkan apakah permintaan berhasil. - **true**: Berhasil - **false**: Gagal |
| errcode | Number | 0 | Kode pengembalian. |
| errmsg | String | ok | Pesan pengembalian. |
| request\_id | String | qkqbwcw3bq2 | ID permintaan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "errmsg":"ok",
  "result": [
    {
      "check_type": "OnDuty",
      "group_id": 394775001,
      "id": 56676915454,
      "is_rest": "N",
      "plan_check_time": "2021-01-14 09:00:00",
      "shift_id": 709595172,
      "shift_version": 617320362,
      "userid": "user456",
      "work_date": "2021-01-14 00:00:00"
    },
    {
      "check_type": "OffDuty",
      "group_id": 394775001,
      "id": 56676915454,
      "is_rest": "N",
      "plan_check_time": "2021-01-14 18:00:00",
      "shift_id": 709595172,
      "shift_version": 617320362,
      "userid": "user456",
      "work_date": "2021-01-14 00:00:00"
    }
  ],
  "success": true,
  "request_id": "4cmy9twx4atn"
}
```

### Kode error

Jika panggilan API ini mengembalikan error, cari solusinya berdasarkan pesan error di dokumen [Kode error 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.