Get Holiday - Gofive OpenAPI

ดึงวันหยุดตามปฏิทิน

ดึงวันหยุดของปฏิทินหนึ่งในปีหนึ่ง ใช้เมื่อระบบภายนอกต้องคำนวณวันทำงาน/วันหยุดให้ตรงกับ empeo

⚠️ โครงสร้างผลลัพธ์ต่างจากที่คาด

Data เป็น array ที่มี หนึ่งรายการต่อหนึ่งวันหยุด โดยแต่ละรายการซ้ำ CalendarName / Year เดิม

DayOff เป็น array ที่มีสมาชิกเพียงตัวเดียว — ผู้เรียกที่ต้องการรายการวันหยุดทั้งปีต้องรวม DayOff ของทุกรายการเข้าด้วยกันเอง

🎛️ ตัวกรอง

calendarName เทียบชื่อแบบ ตรงตัวทั้งชื่อ (ไม่ใช่ contains)

year เป็น ค.ศ.

คืนเฉพาะวันหยุดที่เปิดใช้งานอยู่

🔐 ต้องมีสิทธิ์ Open API โมดูล Master ระดับ Read

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

สำเร็จ — หนึ่งรายการต่อหนึ่งวันหยุด (DayOff มีสมาชิกตัวเดียวเสมอ)

Bodyapplication/json

Example

{
    "StatusCode": 200,
    "Message": "OK",
    "Data": [
        {
            "CalendarName": "ปฏิทินตัวอย่าง สำนักงานใหญ่",
            "Year": 2026,
            "DayOff": [
                {
                    "Date": "2026-01-01",
                    "HolidayName": "วันขึ้นปีใหม่"
                }
            ]
        },
        {
            "CalendarName": "ปฏิทินตัวอย่าง สำนักงานใหญ่",
            "Year": 2026,
            "DayOff": [
                {
                    "Date": "2026-04-13",
                    "HolidayName": "วันสงกรานต์"
                }
            ]
        }
    ]
}

🟢204No Content

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error