Permintaan
| Informasi dasar | |
|---|---|
| URL HTTP | 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. |
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. CorpId |
| name | String | Ya | Shift siang | Nama shift. |
| id | Number | Tidak | 124 | ID shift. Dapatkan dengan memanggil API Mendapatkan ringkasan shift. 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. |
| 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. 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 -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'
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<TopAtSectionVo> sectionVos = new ArrayList<>();
TopAtSectionVo sectionVo = new TopAtSectionVo();
List<TopAtTimeVo> 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());
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)
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");
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<OapiAttendanceShiftAddRequest.TopAtSectionVoDomain> list3 = new List<OapiAttendanceShiftAddRequest.TopAtSectionVoDomain>();
OapiAttendanceShiftAddRequest.TopAtSectionVoDomain obj4 = new OapiAttendanceShiftAddRequest.TopAtSectionVoDomain();
list3.Add(obj4);
List<OapiAttendanceShiftAddRequest.TopAtTimeVoDomain> list6 = new List<OapiAttendanceShiftAddRequest.TopAtTimeVoDomain>();
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
{
"errcode": 0,
"errmsg":"ok",
"result": {
"id": 706715401,
"name": "A1"
},
"success": true,
"request_id": "wp2oh4e4vlbu"
}