Get Change List
ดึงรายการคำขอเปลี่ยนกะ
ใช้ API นี้เพื่อดูรายการคำขอเปลี่ยนกะของพนักงาน สามารถกรองตามช่วงเวลา สถานะ และเงื่อนไขอื่นๆ
Endpoint
GET /api/v1/open-apis/work-cycle-change/get-listRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
start_date | string | Yes | วันที่เริ่มต้น (YYYY-MM-DD) | 2026-01-01 |
end_date | string | Yes | วันที่สิ้นสุด (YYYY-MM-DD) | 2026-01-31 |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | No | รหัสพนักงาน | EMP001 |
approve_flag | string | No | สถานะอนุมัติ (01, 02, 03) | 01 |
work_cycle_mode_lv | string | No | โหมดเปลี่ยนกะ (change, switch) | change |
work_cycle_id | string | No | ID ของกะ | V0MwMDE= |
keyword | string | No | คำค้นหา (ชื่อ, รหัสพนักงาน) | สมชาย |
branch_id | string | No | ID ของสาขา | QlJOMDE= |
department_id | string | No | ID ของแผนก | REVQMDE= |
sort_by | string | No | เรียงตาม field | work_cycle_change_dt |
sort_order | string | No | ลำดับการเรียง (ASC, DESC) | DESC |
_PAGE | number | No | หน้าที่ต้องการ | 1 |
_NUMBER_PER_PAGE | number | No | จำนวนต่อหน้า (1-1000) | 20 |
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"work_cycle_change_id": "V0NDMDAxMjM=",
"employee_code": "EMP001",
"employee_name": "สมชาย",
"employee_last_name": "ใจดี",
"employee_nickname": "ชาย",
"employee_name_en": "Somchai",
"employee_last_name_en": "Jaidee",
"employee_nickname_en": "Chai",
"work_cycle_change_dt": "2026-01-20",
"work_cycle_mode_lv": "change",
"work_cycle_mode_name": "เปลี่ยนกะ",
"work_cycle_mode_name_en": "Change Shift",
"work_cycle_id": "V0MwMDI=",
"work_cycle_code": "B",
"work_start_time": "13:00",
"work_end_time": "22:00",
"work_cycle_change_desc": "ต้องไปธุระช่วงเช้า",
"approve_flag": "01",
"approve_status": "Pending",
"approve_id": null,
"approve_upd": null,
"approve_remark": "",
"created": "2026-01-14 10:00:00",
"created_by": "admin",
"last_upd": "2026-01-14 10:00:00",
"last_upd_by": "admin"
}
],
"_PAGINATION": {
"_TOTAL_RECORDS": 15,
"_PAGE": 1,
"_NUMBER_PER_PAGE": 20
}
}Error Response - Validation Failed (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"errors": [
"Missing required parameter: 'start_date'",
"'end_date' must be greater than or equal to 'start_date'"
]
}Response Fields
| Field | Type | Description |
|---|---|---|
work_cycle_change_id | string | ID ของคำขอเปลี่ยนกะ |
employee_code | string | รหัสพนักงาน |
employee_name | string | ชื่อพนักงาน (ไทย) |
employee_last_name | string | นามสกุลพนักงาน (ไทย) |
employee_nickname | string | ชื่อเล่นพนักงาน (ไทย) |
employee_name_en | string | ชื่อพนักงาน (อังกฤษ) |
employee_last_name_en | string | นามสกุลพนักงาน (อังกฤษ) |
work_cycle_change_dt | string | วันที่เปลี่ยนกะ |
work_cycle_mode_lv | string | โหมด (change, switch) |
work_cycle_mode_name | string | ชื่อโหมด (ไทย) |
work_cycle_mode_name_en | string | ชื่อโหมด (อังกฤษ) |
work_cycle_id | string | ID ของกะที่เปลี่ยนไป |
work_cycle_code | string | รหัสกะ |
work_start_time | string | เวลาเริ่มทำงาน |
work_end_time | string | เวลาสิ้นสุดทำงาน |
work_cycle_change_desc | string | เหตุผล/รายละเอียด |
approve_flag | string | รหัสสถานะอนุมัติ |
approve_status | string | ชื่อสถานะอนุมัติ |
created | datetime | วันเวลาที่สร้าง |
Switch Mode Additional Fields
| Field | Type | Description |
|---|---|---|
work_cycle_switch_dt | string | วันที่สลับกะ |
switch_work_cycle_id_from | string | ID กะเดิม |
switch_work_cycle_id_to | string | ID กะที่สลับไป |
Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/get-list?start_date=2026-01-01&end_date=2026-01-31&employee_code=EMP001" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Approve Flag Values
| Value | Status | Description |
|---|---|---|
01 | Pending | รออนุมัติ (รวม 04-08) |
02 | Approved | อนุมัติแล้ว |
03 | Not Approved | ไม่อนุมัติ |
เมื่อกรอง approve_flag=01 จะรวมสถานะรออนุมัติทุกระดับ (01, 04, 05, 06, 07, 08)
Validation Rules
| Parameter | Validation | Error Message |
|---|---|---|
start_date | ต้องระบุและรูปแบบ YYYY-MM-DD | Missing required parameter: 'start_date' |
end_date | ต้องระบุและรูปแบบ YYYY-MM-DD | Missing required parameter: 'end_date' |
end_date | ต้อง >= start_date | 'end_date' must be greater than or equal to 'start_date' |
approve_flag | ต้องเป็น 01, 02, หรือ 03 | 'approve_flag' must be one of: 01, 02, 03 |
work_cycle_mode_lv | ต้องเป็น change หรือ switch | 'work_cycle_mode_lv' must be 'change' or 'switch' |
Notes
Use Cases
- ดูคำขอเปลี่ยนกะของตัวเอง - กรองตาม employee_code
- HR ตรวจสอบคำขอรออนุมัติ - กรอง approve_flag=01
- รายงานการเปลี่ยนกะ - ดูรายการทั้งหมดในช่วงเวลา
Sorting
- Default:
work_cycle_change_dt DESC - Available fields:
work_cycle_change_dt,employee_code,approve_flag,created
Related APIs
- Submit Change Request - ยื่นคำขอเปลี่ยนกะ
- Update Change Request - แก้ไขคำขอ
- Delete Change Request - ลบคำขอ
Last updated on