Get Work Shifts

ดึงรายการกะการทำงานทั้งหมด แสดงกะพร้อมเวลาเริ่ม-สิ้นสุด ชั่วโมงทำงาน และรายละเอียดอื่นๆ

Endpoint


GET /api/v1/open-apis/salary/get-data-filter?path_action=get_work_shifts

Request Parameters

Parameter	Type	Required	Description	Example
`language_code`	string	No	ภาษา: `TH` หรือ `EN` (ค่าเริ่มต้น: `TH`)	`"TH"`

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "work_cycle_id": "20260121FC89F3BB9120",
      "work_cycle_code": "SHIFT_A",
      "work_cycle_name": "กะเช้า",
      "work_cycle_name_en": "Morning Shift",
      "work_cycle_start_time": "08:00:00",
      "work_cycle_end_time": "17:00:00",
      "work_cycle_hour": "08:00:00",
      "work_cycle_type_lv": "01",
      "work_cycle_type_name": "กะปกติ",
      "work_total_cyele_limit": "08:00:00",
      "active_flag": "Y"
    },
    {
      "work_cycle_id": "20260121FC89F3BB9121",
      "work_cycle_code": "SHIFT_B",
      "work_cycle_name": "กะบ่าย",
      "work_cycle_name_en": "Afternoon Shift",
      "work_cycle_start_time": "13:00:00",
      "work_cycle_end_time": "22:00:00",
      "work_cycle_hour": "08:00:00",
      "work_cycle_type_lv": "01",
      "work_cycle_type_name": "กะปกติ",
      "work_total_cyele_limit": "08:00:00",
      "active_flag": "Y"
    },
    {
      "work_cycle_id": "20260121FC89F3BB9122",
      "work_cycle_code": "SHIFT_C",
      "work_cycle_name": "กะดึก",
      "work_cycle_name_en": "Night Shift",
      "work_cycle_start_time": "22:00:00",
      "work_cycle_end_time": "07:00:00",
      "work_cycle_hour": "08:00:00",
      "work_cycle_type_lv": "02",
      "work_cycle_type_name": "กะข้ามวัน",
      "work_total_cyele_limit": "08:00:00",
      "active_flag": "Y"
    }
  ]
}

Response Fields

Field	Type	Nullable	Description
`work_cycle_id`	string	No	รหัสกะ (20 ตัวอักษร)
`work_cycle_code`	string	No	รหัสย่อกะ
`work_cycle_name`	string	No	ชื่อกะ (ภาษาไทย)
`work_cycle_name_en`	string	Yes	ชื่อกะ (ภาษาอังกฤษ)
`work_cycle_start_time`	string	No	เวลาเริ่มกะ (HH:mm:ss)
`work_cycle_end_time`	string	No	เวลาสิ้นสุดกะ (HH:mm:ss)
`work_cycle_hour`	string	No	ชั่วโมงทำงานมาตรฐานในกะ (HH:mm:ss)
`work_cycle_type_lv`	string	No	รหัสประเภทกะ (ดูตารางด้านล่าง)
`work_cycle_type_name`	string	Yes	ชื่อประเภทกะ
`work_total_cyele_limit`	string	Yes	ชั่วโมงทำงานสูงสุดที่อนุญาต (HH:mm:ss)
`active_flag`	string	No	สถานะใช้งาน: `"Y"` (ใช้งาน), `"N"` (ไม่ใช้งาน)

ประเภทกะ (work_cycle_type_lv)

Code	ชื่อ	Description
`"00"`	กำหนดเวลาเข้าออก ในวันเดียวกัน	Same day work shift
`"01"`	กำหนดชั่วโมงการทำงานรวม	Total working hours
`"02"`	กำหนดเวลาเข้าออก ข้ามเที่ยงคืนของพรุ่งนี้	After midnight shift
`"03"`	กำหนดเวลาเข้าออก ข้ามเที่ยงคืนของเมื่อวาน	Before midnight shift
`"04"`	กำหนดควบกะการทำงาน	Multiple shift
`"05"`	กำหนดกะการทำงานโดยไม่ต้องลงเวลา	No time attendance

Error Response


{
  "code": 500,
  "message": "Internal server error"
}

Code Examples

cURL


# ดูรายการกะการทำงานทั้งหมด (ภาษาไทย)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_work_shifts&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# ดูรายการกะการทำงาน (ภาษาอังกฤษ)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_work_shifts&language_code=EN" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_work_shifts',
  language_code: 'TH'
})
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
data.payload.forEach(shift => {
  console.log(`${shift.work_cycle_code}: ${shift.work_cycle_name} (${shift.work_cycle_start_time} - ${shift.work_cycle_end_time})`)
})

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "get_work_shifts", "language_code": "TH"}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for shift in data["payload"]:
    print(f"{shift['work_cycle_code']}: {shift['work_cycle_name']} ({shift['work_cycle_start_time']} - {shift['work_cycle_end_time']})")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_work_shifts",
    "language_code" => "TH"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?{$params}";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
foreach ($data["payload"] as $shift) {
    echo "{$shift['work_cycle_code']}: {$shift['work_cycle_name']} ({$shift['work_cycle_start_time']} - {$shift['work_cycle_end_time']})\n";
}
?>

Notes

API นี้จะแสดงกะการทำงานทั้งหมดในระบบ ทั้งที่ใช้งานอยู่และที่ปิดใช้งานแล้ว ตรวจสอบ active_flag เพื่อกรองเฉพาะกะที่ใช้งานอยู่
work_cycle_hour คือชั่วโมงทำงานมาตรฐาน ส่วน work_total_cyele_limit คือชั่วโมงทำงานสูงสุดที่อนุญาต
ข้อมูลกะการทำงานเป็น Master Data ที่ไม่เปลี่ยนแปลงบ่อย แนะนำให้ทำ cache เพื่อเพิ่มประสิทธิภาพ

กะประเภท "02" (ข้ามเที่ยงคืนของพรุ่งนี้) และ "03" (ข้ามเที่ยงคืนของเมื่อวาน) จะมีเวลาเริ่มกะมากกว่าเวลาสิ้นสุดกะ เนื่องจากเป็นกะที่ข้ามวัน

Get Holiday Types - ดึงรายการประเภทวันหยุด
Get Company Holidays - ดึงรายการวันหยุดบริษัท
Get Extra Holiday Quota - ดึงโควตาวันหยุดพิเศษ
Get Calendar Month - ดูปฏิทินทั้งเดือนตามรอบเงินเดือน