Get Calendar Month Filter

ดึงปฏิทินการทำงานตามช่วงวันที่ที่ระบุ ไม่จำกัดตามรอบเงินเดือน แสดงรายการพนักงานที่ทำงาน/ลา/หยุดในแต่ละวัน

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`start_date`	string	Yes	วันที่เริ่มต้น (YYYY-MM-DD)	`"2026-02-01"`
`end_date`	string	Yes	วันที่สิ้นสุด (YYYY-MM-DD)	`"2026-02-28"`
`type`	string	Yes	ประเภทการกรอง: `"leave"`, `"work_cycle"`, `"holiday"`	`"leave"`
`time_leave_flag`	string	No	รหัสประเภทการลา (ใช้เมื่อ type=leave)	`"01"`
`work_cycle_id`	string	No	รหัสกะการทำงาน (Base64, ใช้เมื่อ type=work_cycle)	-
`holiday_flag_lv`	string	No	รหัสประเภทวันหยุด (ใช้เมื่อ type=holiday)	`"01"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN`	`"TH"`

Filter Types

Type	Description
`"leave"`	ลางาน — แสดงเฉพาะพนักงานที่ลางาน
`"work_cycle"`	กะการทำงาน — แสดงพนักงานตามกะที่ระบุ
`"holiday"`	วันหยุด — แสดงเฉพาะพนักงานที่มีวันหยุด

Leave Types (time_leave_flag)

Code	Description
`"01"`	ลากิจได้รับค่าจ้าง
`"02"`	ลากิจไม่ได้รับค่าจ้าง
`"03"`	ลาป่วยมีใบรับรองแพทย์
`"06"`	ลาพักร้อน
`"09"`	ขาดงาน

Holiday Types (holiday_flag_lv)

Code	Description
`"01"`	วันหยุดนักขัตฤกษ์
`"03"`	วันหยุดพนักงาน
`"04"`	วันหยุดพิเศษ

Response Format

Success Response (type=leave)


{
  "code": 200,
  "message": "Get Calendar Month Accept",
  "payload": {
    "2026-02-03": [
      {
        "employee_code": "EMP001",
        "employee_name": "สมชาย",
        "employee_last_name": "ใจดี",
        "position_name": "โปรแกรมเมอร์",
        "department_name": "ฝ่ายพัฒนา",
        "organization": {
          "company": { "label": "บริษัท", "value": "บริษัท ตัวอย่าง จำกัด" },
          "branch": { "label": "สาขา", "value": "สำนักงานใหญ่" },
          "department": { "label": "แผนก", "value": "ฝ่ายพัฒนา" }
        },
        "work_date": "2026-02-03"
      }
    ]
  }
}

Success Response (type=work_cycle or holiday)

Response จะมี fields เพิ่มเติม: work_cycle_code, work_cycle_start_time, work_cycle_end_time, absence_flag_lv, day_status

Error Response


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": { "type": "Invalid type. Expected: leave, work_cycle, or holiday" }
}

Code Examples

cURL


# ดูปฏิทินการลาในเดือนกุมภาพันธ์
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_calendar_month_filter&start_date=2026-02-01&end_date=2026-02-28&type=leave&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_calendar_month_filter&start_date=2026-01-01&end_date=2026-03-31&type=holiday&holiday_flag_lv=01&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_calendar_month_filter',
  start_date: '2026-02-01',
  end_date: '2026-02-28',
  type: 'leave',
  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()
Object.entries(data.payload).forEach(([date, employees]) => {
  console.log(`${date}: ${employees.map(e => e.employee_name).join(', ')}`)
})

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_calendar_month_filter",
    "start_date": "2026-02-01",
    "end_date": "2026-02-28",
    "type": "leave",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for date, employees in data["payload"].items():
    names = ", ".join(e["employee_name"] for e in employees)
    print(f"{date}: {names}")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_calendar_month_filter",
    "start_date" => "2026-02-01",
    "end_date" => "2026-02-28",
    "type" => "leave",
    "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 $date => $employees) {
    $names = implode(", ", array_column($employees, "employee_name"));
    echo "{$date}: {$names}\n";
}
?>

Notes

API นี้ต้องระบุ type เสมอ (ไม่สามารถเป็น null ได้ — ต่างจาก Get Calendar Month)
สำหรับ type=leave ระบบจะ expand เอกสารลาข้ามวันเป็นรายวัน
แนะนำให้จำกัดช่วงวันที่ไม่เกิน 3 เดือนเพื่อประสิทธิภาพ
Response สำหรับ type=leave จะไม่มี work_cycle fields

Get Calendar Month - ดูปฏิทินตามรอบเงินเดือน (รองรับ type=null)