Get Time Attendance - Gofive OpenAPI

ดึงผลการคำนวณเวลาทำงานรายวัน

ดึงผลการคำนวณเวลาทำงานรายวันของพนักงาน — เวลาเข้า-ออกที่ระบบใช้คำนวณ, นาทีสาย/ออกก่อน/ขาดงาน, ชื่อกะ
และนาที OT แยกตามอัตรา ใช้เมื่อระบบเงินเดือนหรือ BI ภายนอกต้องดึงผลคำนวณไปใช้ต่อ

⚠️ ข้อควรรู้

ต้องส่ง DateStart และ DateEnd เสมอ — ไม่ส่งจะได้ 400 พร้อมข้อความ DateStart and DateEnd are required.

ไม่มี 204 — ไม่พบข้อมูลจะได้ 200 พร้อม Data เป็น array ว่าง

endpoint นี้ใช้สิทธิ์โมดูล Attendance ไม่ใช่ Time

📘 การอ่านเวลาในผลลัพธ์

StampIn / StampOut = เวลาที่ระบบใช้คำนวณ (ปรับตามกะแล้ว)

RealStampIn / RealStampOut = เวลาที่ตอกจริง

ทั้งสี่ฟิลด์เป็น null ได้เมื่อวันนั้นไม่มีการตอกบัตร

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

สำเร็จ — Data คือผลการคำนวณรายวัน (array ว่างเมื่อไม่มีข้อมูล)

Bodyapplication/json

Example

{
    "Status": {
        "Code": "1000",
        "Description": "Success!"
    },
    "Data": [
        {
            "EmployeeNo": "EMP001",
            "FullName": "พนักงานตัวอย่าง หนึ่ง",
            "FullName_EN": "Sample Employee One",
            "Date": "2026-06-01T00:00:00",
            "StampIn": "08:00:00",
            "StampOut": "17:00:00",
            "RealStampIn": "07:58:00",
            "RealStampOut": "17:05:00",
            "WorkTime": 480,
            "Late": 0,
            "Early": 0,
            "Absence": 0,
            "ShiftName": "กะเช้าตัวอย่าง",
            "ShiftName_EN": "Sample Morning Shift",
            "Status": "มาทำงาน",
            "Status_EN": "Present",
            "LeaveCodeString": "",
            "TotalMinuteOfOT": 0,
            "MinuteOfOT1": 0,
            "MinuteOfOT2": 0,
            "MinuteOfOT3": 0,
            "MinuteOfOT4": 0
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error