> ## 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. # Buat shift > Panggil API DingTalk untuk membuat shift absensi baru dan mengatur nama, waktu absen masuk dan pulang, sesi absen, serta waktu istirahat. Panggil API ini untuk membuat shift absensi DingTalk. ## Permintaan | **Informasi dasar** | | | - | - | | URL HTTP | [https://api.dingtalk.io/topapi/attendance/shift/add](https://api.dingtalk.io/topapi/attendance/shift/add) | | Metode HTTP | POST | | Tipe aplikasi yang didukung | appType-Aplikasi internal | | Izin yang diperlukan | permission-qyapi\_attendance\_group\_manage-Izin pengelolaan grup absensi | ### Parameter kueri | Nama | Tipe | Wajib | Contoh | Deskripsi | | - | - | - | - | - | | access\_token | String | Ya | 6d1bxxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini. Dapatkan dengan memanggil API [Mendapatkan access\_token aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token). | ### Isi permintaan | Nama | Tipe | Wajib | Contoh | Deskripsi | | - | - | - | - | - | | op\_user\_id | String | Ya | user01 | userId operator. | | shift | TopAtClassVo | Ya | | Shift. | | owner | String | Tidak | user01 | Pemilik shift. | | class\_group\_name | String | Tidak | def | Nama grup shift. | | corp\_id | String | Tidak | ding23 | ID organisasi (corpId). Temukan di [Developer Console](https://open-dev.dingtalk.io/). CorpId | | name | String | Ya | Shift siang | Nama shift. | | id | Number | Tidak | 124 | ID shift. Dapatkan dengan memanggil API [Mendapatkan ringkasan shift](https://help.dingtalk.io/id/open/development/enterprise-shift-query-in-batches.md). **Catatan** Kosongkan id untuk membuat shift. Isi id untuk mengubah shift yang sudah ada. | | sections | TopAtSectionVo\[] | Ya | | Sesi absen. | | times | TopAtTimeVo\[] | Ya | | Informasi absen. | | check\_type | String | Ya | OnDuty | Tipe absen: - **OnDuty**: Absen masuk - **OffDuty**: Absen pulang | | across | Number | Ya | 0 | Apakah waktu melewati hari berikutnya: - **0**: Hari yang sama - **1**: Hari berikutnya | | end\_min | Number | Tidak | -1 | Batas waktu absen paling lambat, dalam menit. -1 berarti tanpa batas. | | check\_time | Date | Ya | 2020-12-02 09:00:00 | Waktu absen. | | free\_check | Boolean | Tidak | false | Apakah dibebaskan dari absen: - **false**: Wajib absen - **true**: Bebas absen | | begin\_min | Number | Tidak | 30 | Batas waktu absen paling awal sebelum jadwal, dalam menit. | | setting | TopAtClassSettingVo | Tidak | | Pengaturan. | | rest\_begin\_time | TopAtTimeVo | Tidak | | Awal istirahat. | | check\_type | String | Tidak | OnDuty | Tipe istirahat: - **OnDuty**: Mulai istirahat - **OffDuty**: Selesai istirahat | | check\_time | Date | Tidak | 2020-12-02 09:00:00 | Waktu absen istirahat. | | free\_check | Boolean | Tidak | false | Apakah dibebaskan dari absen: - **true**: Bebas absen - **false**: Wajib absen | | across | Number | Tidak | 0 | Apakah waktu melewati hari berikutnya. Melewati berarti waktu istirahat jatuh pada hari berikutnya: - **0**: Hari yang sama - **1**: Hari berikutnya | | class\_id | Number | Tidak | 221 | ID shift. Dapatkan dengan memanggil API [Mendapatkan ringkasan shift](https://help.dingtalk.io/id/open/development/enterprise-shift-query-in-batches.md). | | is\_flexible | Boolean | Tidak | false | Apakah shift bersifat fleksibel: - **true**: Fleksibel - **false**: Tidak fleksibel | | corp\_id | String | Tidak | ding121 | ID organisasi (corpId). Temukan di [Developer Console](https://open-dev.dingtalk.io/). CorpId | | is\_deleted | String | Tidak | N | Apakah shift telah dihapus: - **N**: Ya - **Y**: Tidak | | rest\_end\_time | TopAtTimeVo | Tidak | | Akhir istirahat. | | check\_type | String | Tidak | OffDuty | Tipe istirahat: - **OnDuty**: Mulai istirahat - **OffDuty**: Selesai istirahat | | check\_time | Date | Tidak | 2020-12-02 09:00:00 | Waktu istirahat. | | free\_check | Boolean | Tidak | false | Apakah dibebaskan dari absen: - **false**: Wajib absen - **true**: Bebas absen | | across | Number | Tidak | 1 | Apakah waktu melewati hari berikutnya. Melewati berarti waktu istirahat jatuh pada hari berikutnya: - **0**: Hari yang sama - **1**: Hari berikutnya | | serious\_late\_minutes | Number | Tidak | 31 | Durasi yang dihitung sebagai keterlambatan atau pulang lebih awal berat, dalam menit. | | absenteeism\_late\_minutes | Number | Tidak | 60 | Durasi keterlambatan atau pulang lebih awal yang dihitung sebagai mangkir, dalam menit. **Catatan** Nilai ini harus lebih besar daripada durasi keterlambatan berat. | | extras | Json | Tidak | `{"cause":"{\"type\":\"approve\",\"relatedId\":\"43494469-21a6-4111-953b-7810a709f27f\"}"}` | Bidang ekstensi untuk pengaturan shift. Tidak diperlukan untuk shift non-sementara. | | tags | String | Tidak | temp:schedule:isv | Tag shift. Tidak diperlukan untuk shift non-sementara. | ### Contoh permintaan ```curl theme={"theme":{"light":"github-light","dark":"github-dark"}} curl -X POST "https://api.dingtalk.io/topapi/attendance/shift/add" \ -H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \ -d 'access_token=39cbcxxxx9058' \ -d 'op_user_id=abc' \ -d 'shift=null' ``` Java ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/shift/add"); OapiAttendanceShiftAddRequest request = new OapiAttendanceShiftAddRequest(); TopAtClassVo topAtClassVo = new TopAtClassVo(); topAtClassVo.setOwner("user456"); topAtClassVo.setClassGroupName("Grup shift uji"); topAtClassVo.setCorpId("dinge8a56572xxxx"); topAtClassVo.setName("A1"); List sectionVos = new ArrayList<>(); TopAtSectionVo sectionVo = new TopAtSectionVo(); List timeVos = new ArrayList<>(); TopAtTimeVo timeVo = new TopAtTimeVo(); timeVo.setAcross(0L); timeVo.setBeginMin(0L); timeVo.setCheckTime(StringUtils.parseDateTime("2020-12-02 09:00:00")); timeVo.setCheckType("OnDuty"); timeVo.setEndMin(-1L); timeVo.setFreeCheck(false); TopAtTimeVo timeVo1 = new TopAtTimeVo(); timeVo1.setAcross(0L); timeVo1.setEndMin(0L); timeVo1.setCheckTime(StringUtils.parseDateTime("2020-12-02 18:00:00")); timeVo1.setCheckType("OffDuty"); timeVo1.setEndMin(-1L); timeVo1.setFreeCheck(false); timeVos.add(timeVo); timeVos.add(timeVo1); sectionVo.setTimes(timeVos); sectionVos.add(sectionVo); topAtClassVo.setSections(sectionVos); TopAtClassSettingVo settingVo = new TopAtClassSettingVo(); topAtClassVo.setSetting(settingVo); TopAtTimeVo restBeginTime = new TopAtTimeVo(); settingVo.setRestBeginTime(restBeginTime); restBeginTime.setFreeCheck(false); restBeginTime.setAcross(1L); restBeginTime.setCheckType("OnDuty"); restBeginTime.setFreeCheck(false); restBeginTime.setCheckTime(StringUtils.parseDateTime("2020-12-02 12:00:00")); TopAtTimeVo restEndTime = new TopAtTimeVo(); settingVo.setRestEndTime(restEndTime); restEndTime.setAcross(1L); restEndTime.setCheckType("OffDuty"); restEndTime.setFreeCheck(false); restEndTime.setCheckTime(StringUtils.parseDateTime("2020-12-02 13:00:00")); settingVo.setCorpId("dinge8a56572xxxx"); settingVo.setIsDeleted("N"); settingVo.setAbsenteeismLateMinutes(60L); settingVo.setIsFlexible(false); settingVo.setSeriousLateMinutes(30L); request.setOpUserId("user456"); request.setShift(topAtClassVo); OapiAttendanceShiftAddResponse response = client.execute(request, access_token); System.out.println(response.getBody()); ``` Python ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} import dingtalk.api req=dingtalk.api.OapiAttendanceShiftAddRequest("https://api.dingtalk.io/topapi/attendance/shift/add") req.op_user_id="abc" req.shift="" 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 OapiAttendanceShiftAddRequest; $req->setOpUserId("abc"); $shift = new TopAtClassVo; $shift->owner="abc"; $shift->class_group_name="def"; $shift->corp_id="ding23"; $shift->name="Shift siang"; $sections = new TopAtSectionVo; $times = new TopAtTimeVo; $times->check_type="OnDuty"; $times->across="0"; $times->end_min="-1"; $times->check_time="2020-03-17 12:00:00"; $times->free_check="false"; $times->begin_min="30"; $sections->times = array($times); $shift->sections = array($sections); $setting = new TopAtClassSettingVo; $rest_begin_time = new TopAtTimeVo; $rest_begin_time->check_type="OnDuty"; $rest_begin_time->check_time="2020-03-17 12:00:00"; $rest_begin_time->free_check="false"; $rest_begin_time->across="0"; $setting->rest_begin_time = $rest_begin_time; $setting->is_flexible="false"; $setting->corp_id="ding121"; $setting->is_deleted="N"; $rest_end_time = new TopAtTimeVo; $rest_end_time->check_type="OffDuty"; $rest_end_time->check_time="2020-03-17 13:00:00"; $rest_end_time->free_check="false"; $rest_end_time->across="1"; $setting->rest_end_time = $rest_end_time; $setting->serious_late_minutes="31"; $setting->absenteeism_late_minutes="60"; $shift->setting = $setting; $req->setShift($shift); $resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/shift/add"); ``` C# ```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}} IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/shift/add"); OapiAttendanceShiftAddRequest req = new OapiAttendanceShiftAddRequest(); req.OpUserId = "abc"; OapiAttendanceShiftAddRequest.TopAtClassVoDomain obj1 = new OapiAttendanceShiftAddRequest.TopAtClassVoDomain(); obj1.Owner = "abc"; obj1.ClassGroupName = "def"; obj1.CorpId = "ding23"; obj1.Name = "Shift siang"; List list3 = new List(); OapiAttendanceShiftAddRequest.TopAtSectionVoDomain obj4 = new OapiAttendanceShiftAddRequest.TopAtSectionVoDomain(); list3.Add(obj4); List list6 = new List(); OapiAttendanceShiftAddRequest.TopAtTimeVoDomain obj7 = new OapiAttendanceShiftAddRequest.TopAtTimeVoDomain(); list6.Add(obj7); obj7.CheckType = "OnDuty"; obj7.Across = 0L; obj7.EndMin = -1L; obj7.CheckTime = DateTime.Parse("2020-03-17 12:00:00"); obj7.FreeCheck = false; obj7.BeginMin = 30L; obj4.Times= list6; obj1.Sections= list3; OapiAttendanceShiftAddRequest.TopAtClassSettingVoDomain obj8 = new OapiAttendanceShiftAddRequest.TopAtClassSettingVoDomain(); OapiAttendanceShiftAddRequest.TopAtTimeVoDomain obj9 = new OapiAttendanceShiftAddRequest.TopAtTimeVoDomain(); obj9.CheckType = "OnDuty"; obj9.CheckTime = DateTime.Parse("2020-03-17 12:00:00"); obj9.FreeCheck = false; obj9.Across = 0L; obj8.RestBeginTime= obj9; obj8.IsFlexible = false; obj8.CorpId = "ding121"; obj8.IsDeleted = "N"; OapiAttendanceShiftAddRequest.TopAtTimeVoDomain obj10 = new OapiAttendanceShiftAddRequest.TopAtTimeVoDomain(); obj10.CheckType = "OffDuty"; obj10.CheckTime = DateTime.Parse("2020-03-17 13:00:00"); obj10.FreeCheck = false; obj10.Across = 1L; obj8.RestEndTime= obj10; obj8.SeriousLateMinutes = 31L; obj8.AbsenteeismLateMinutes = 60L; obj1.Setting= obj8; req.Shift_ = obj1; OapiAttendanceShiftAddResponse rsp = client.Execute(req, access_token); Console.WriteLine(rsp.Body); ``` ## Respons ### Isi respons | Nama | Tipe | Contoh | Deskripsi | | - | - | - | - | | result | TopAtClassVo | | Informasi shift. | | id | Number | 706715401 | ID shift. | | name | String | A1 | Nama shift. | | errmsg | String | ok | Deskripsi kode respons. | | errcode | Number | 0 | Kode respons. | | success | Boolean | true | Apakah panggilan berhasil: - **true**: Berhasil - **false**: Gagal | | request\_id | String | wp2oh4e4vlbu | ID permintaan. | ### Contoh isi respons ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "errcode": 0, "errmsg":"ok", "result": { "id": 706715401, "name": "A1" }, "success": true, "request_id": "wp2oh4e4vlbu" } ``` ### Kode error Jika panggilan API 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.