Get Employee Workday

ดึงข้อมูลรูปแบบวันทำงาน (Workday Pattern) ของพนักงาน รวมถึงการตั้งค่ากะการทำงานในแต่ละวัน

รูปแบบวันทำงานกำหนดว่าพนักงานจะทำงานกะไหนในแต่ละวัน และวันไหนเป็นวันหยุด

Endpoint


GET /api/v1/open-apis/holiday/get-employee-workday

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการดึงข้อมูล	`EMP001`

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "holiday_apply_config": "01",
    "holiday_day_json": "{\"Mon\":\"WC001\",\"Tue\":\"WC001\",\"Wed\":\"WC001\",\"Thu\":\"WC001\",\"Fri\":\"WC001\",\"Sat\":\"OFF\",\"Sun\":\"OFF\"}",
    "holiday_format": "WF001",
    "holiday_lists": {
      "Mon": "A : 08:00-17:00",
      "Tue": "A : 08:00-17:00",
      "Wed": "A : 08:00-17:00",
      "Thu": "A : 08:00-17:00",
      "Fri": "A : 08:00-17:00",
      "Sat": "วันหยุด",
      "Sun": "วันหยุด"
    }
  }
}

Error Response (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Missing required parameter: employee_code"
}

Response Fields

Field	Type	Description
`holiday_apply_config`	string	การตั้งค่าการใช้งาน Holiday (`01` = ใช้งาน)
`holiday_day_json`	string	JSON string ของรูปแบบวันทำงาน (key=วัน, value=work_cycle_id)
`holiday_format`	string	รูปแบบวันทำงาน (Work Cycle Format ID)
`holiday_lists`	object	รายการวันทำงานแปลงเป็น Label (key=วัน, value=ชื่อกะการทำงาน)

Day Keys

Key	Day
`Mon`	Monday (วันจันทร์)
`Tue`	Tuesday (วันอังคาร)
`Wed`	Wednesday (วันพุธ)
`Thu`	Thursday (วันพฤหัสบดี)
`Fri`	Friday (วันศุกร์)
`Sat`	Saturday (วันเสาร์)
`Sun`	Sunday (วันอาทิตย์)

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/holiday/get-employee-workday?employee_code=EMP001" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const employeeCode = 'EMP001'
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/holiday/get-employee-workday?employee_code=${employeeCode}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
// Parse holiday_day_json
const workdayPattern = JSON.parse(data.payload.holiday_day_json)
 
// แสดงตารางกะการทำงาน
Object.entries(data.payload.holiday_lists).forEach(([day, shift]) => {
  console.log(`${day}: ${shift}`)
})

Python


import requests
import json
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/holiday/get-employee-workday"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "employee_code": "EMP001"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
# Parse holiday_day_json
workday_pattern = json.loads(data['payload']['holiday_day_json'])
 
# แสดงตารางกะการทำงาน
for day, shift in data['payload']['holiday_lists'].items():
    print(f"{day}: {shift}")

PHP


<?php
$employeeCode = "EMP001";
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/holiday/get-employee-workday?employee_code=" . $employeeCode;
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
// Parse holiday_day_json
$workdayPattern = json_decode($data['payload']['holiday_day_json'], true);
 
// แสดงตารางกะการทำงาน
foreach ($data['payload']['holiday_lists'] as $day => $shift) {
    echo "{$day}: {$shift}\n";
}
 
curl_close($ch);
?>

Data Structure

holiday_day_json (Parsed)


{
  "Mon": "WC001",
  "Tue": "WC001",
  "Wed": "WC001",
  "Thu": "WC001",
  "Fri": "WC001",
  "Sat": "OFF",
  "Sun": "OFF"
}

work_cycle_id (เช่น WC001) = วันทำงานพร้อมกะการทำงาน
OFF = วันหยุด

holiday_lists


{
  "Mon": "A : 08:00-17:00",
  "Tue": "A : 08:00-17:00",
  "Wed": "A : 08:00-17:00",
  "Thu": "A : 08:00-17:00",
  "Fri": "A : 08:00-17:00",
  "Sat": "วันหยุด",
  "Sun": "วันหยุด"
}

holiday_day_json เป็น JSON string ต้อง parse ก่อนใช้งาน ส่วน holiday_lists แปลงเป็น Label พร้อมแสดงแล้ว

Notes

Use Cases

แสดงรูปแบบวันทำงาน - แสดงการตั้งค่ากะการทำงานรายวันของพนักงาน
ตรวจสอบวันทำงาน - ดูว่าพนักงานทำงานวันไหนบ้างและหยุดวันไหน
เตรียมข้อมูลก่อนแก้ไข - ดึงข้อมูลเดิมก่อนทำการอัพเดท
แสดงตารางกะการทำงาน - สร้างตารางแสดงกะการทำงานรายสัปดาห์

Empty Data

ถ้า holiday_day_json เป็น null หรือว่าง = ยังไม่มีการตั้งค่ารูปแบบวันทำงาน
ถ้า holiday_lists ว่างเปล่า = ไม่สามารถแปลงข้อมูลได้

Error Handling

Error	Cause	Solution
`Missing required parameter: employee_code`	ไม่ได้ส่ง employee_code	ตรวจสอบว่าส่ง employee_code ใน query parameter
`Employee not found with code: XXX`	ไม่พบพนักงานในระบบ	ตรวจสอบว่า employee_code ถูกต้อง

Update Employee Workday - แก้ไขรูปแบบวันทำงาน