Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Holiday Types

ดึงรายการประเภทวันหยุดทั้งหมด ใช้สำหรับแสดง dropdown เลือกประเภทวัน หรือกรองข้อมูลปฏิทินตามประเภทวันหยุด

Endpoint

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

Request Parameters

ParameterTypeRequiredDescriptionExample
language_codestringNoภาษา: TH หรือ EN (ค่าเริ่มต้น: TH)"TH"

Response Format

Success Response

{ "code": 200, "message": "สำเร็จ", "payload": [ { "code": "00", "name": "วันทำงาน", "name_en": "Workday" }, { "code": "01", "name": "วันหยุดนักขัตฤกษ์", "name_en": "Public Holiday" }, { "code": "03", "name": "วันหยุดพนักงาน", "name_en": "Employee Holiday" }, { "code": "04", "name": "วันหยุดพิเศษ", "name_en": "Extra Holiday" } ] }

Response Fields

FieldTypeNullableDescription
codestringNoรหัสประเภทวันหยุด (holiday_flag_lv)
namestringNoชื่อประเภทวันหยุด (ภาษาไทย)
name_enstringNoชื่อประเภทวันหยุด (ภาษาอังกฤษ)

ค่า holiday_flag_lv

Codeชื่อ (TH)ชื่อ (EN)Description
"00"วันทำงานWorkdayวันทำงานปกติ
"01"วันหยุดนักขัตฤกษ์Public Holidayวันหยุดประจำปี/นักขัตฤกษ์
"03"วันหยุดพนักงานEmployee Holidayวันหยุดของพนักงานเฉพาะคน
"04"วันหยุดพิเศษExtra Holidayวันหยุดพิเศษที่ใช้โควตา

Error Response

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

Code Examples

# ดูประเภทวันหยุด (ภาษาไทย) curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_holiday_types&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_holiday_types&language_code=EN" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

Notes

  • ค่าประเภทวันหยุดเป็นข้อมูลที่กำหนดไว้ในระบบ ไม่สามารถเพิ่มหรือแก้ไขผ่าน API ได้
  • ใช้ค่า code ที่ได้จาก API นี้เป็นค่า holiday_flag_lv เมื่อเรียก API อื่นที่ต้องระบุประเภทวันหยุด
  • ข้อมูลประเภทวันหยุดเป็น Master Data ที่ไม่เปลี่ยนแปลง แนะนำให้ทำ cache เพื่อเพิ่มประสิทธิภาพ

ประเภทวันหยุด "04" (วันหยุดพิเศษ) ต้องตรวจสอบโควตาคงเหลือของพนักงานก่อนใช้งาน โดยเรียก Get Extra Holiday Quota เพื่อตรวจสอบว่ายังมีโควตาเหลืออยู่


  • Get Work Shifts - ดึงรายการกะการทำงาน
  • Get Company Holidays - ดึงรายการวันหยุดบริษัท
  • Get Extra Holiday Quota - ดึงโควตาวันหยุดพิเศษ (ใช้กับ code = ‘04’)
  • Get Calendar Month - ดูปฏิทินทั้งเดือนตามรอบเงินเดือน
Last updated on