Get Upcoming Celebrations - Gofive OpenAPI

ดึงวันสำคัญของพนักงานที่กำลังจะมาถึง

ดึงรายการวันสำคัญของพนักงานในช่วงวันที่ที่ระบุ จัดกลุ่มเป็นรายวัน (หนึ่งรายการใน Data = หนึ่งวัน)
และเรียงวันจากเก่าไปใหม่ ภายในแต่ละวันเรียงตามประเภทวันสำคัญแล้วตามชื่อพนักงาน
ใช้ POST เพื่อส่งชื่อบริษัทภาษาไทยและช่วงวันที่ใน JSON body ได้อย่างปลอดภัย

🎛️ ค่าเริ่มต้นเมื่อไม่ส่ง (ทุก field เป็น optional)

DateStart → วันนี้

DateEnd → วันนี้ + 30 วัน

CompanyName → ทุกบริษัทใน tenant

EmployeeRefId → ทุกพนักงานที่ผู้เรียกมองเห็น

⚠️ ข้อควรรู้

DateStart / DateEnd เป็นวันที่แบบไม่มี timezone (ระบบใช้เฉพาะส่วนวันที่)

ไม่พบรายการจะคืน 204 โดยไม่มี body

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/json

Example

{
    "DateStart": "2026-09-01T00:00:00",
    "DateEnd": "2026-09-30T00:00:00",
    "EmployeeRefId": "EMP001",
    "CompanyName": "Acme"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

พบวันสำคัญในช่วงวันที่ที่ระบุ จัดกลุ่มตามวัน

Bodyapplication/json

Example

{
    "Status": {
        "Code": "1000",
        "Description": "Success!"
    },
    "Data": [
        {
            "Date": "5 กันยายน 2569",
            "Date_EN": "5 September 2026",
            "DateSort": "2026-09-05T00:00:00",
            "Employees": [
                {
                    "CelebrationType": 14002,
                    "EmployeeId": 1011,
                    "EmployeeNo": "EMP001",
                    "Name": "พนักงานตัวอย่าง",
                    "Name_EN": "Sample",
                    "FullName": "พนักงานตัวอย่าง หนึ่ง",
                    "FullName_EN": "Sample One",
                    "CelebrationName": "สุขสันต์วันเกิด",
                    "YearAnniversary": 0,
                    "MovementTransactionId": 0,
                    "PictureMediumURL": "https://cdn.example.com/employees/emp001-medium.png",
                    "HasTempCelebration": false,
                    "CompanyId": 1,
                    "CelebrationId": 501,
                    "Description": "สุขสันต์วันเกิดนะ",
                    "CustomCard": "https://cdn.example.com/celebration-cards/birthday.png",
                    "UserSharing": "EMP002",
                    "Attachment": [
                        {
                            "AttachmentNo": 1,
                            "AttachmentURL": "https://cdn.example.com/celebrations/501/photo.jpg",
                            "AttachmentThumbnailURL": "https://cdn.example.com/celebrations/501/photo-thumb.jpg"
                        }
                    ]
                }
            ]
        },
        {
            "Date": "12 กันยายน 2569",
            "Date_EN": "12 September 2026",
            "DateSort": "2026-09-12T00:00:00",
            "Employees": [
                {
                    "CelebrationType": 14005,
                    "EmployeeId": 1012,
                    "EmployeeNo": "EMP002",
                    "Name": "พนักงานตัวอย่าง",
                    "Name_EN": "Sample",
                    "FullName": "พนักงานตัวอย่าง สอง",
                    "FullName_EN": "Sample Two",
                    "CelebrationName": "สุขสันต์วันครบรอบ",
                    "YearAnniversary": 3,
                    "MovementTransactionId": 0,
                    "PictureMediumURL": "https://cdn.example.com/employees/emp002-medium.png",
                    "HasTempCelebration": false,
                    "CompanyId": 1,
                    "CelebrationId": 0,
                    "Description": "",
                    "CustomCard": "",
                    "UserSharing": "",
                    "Attachment": []
                }
            ]
        }
    ]
}

🟢204No Content

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error