Get Employee Shifts - Gofive OpenAPI

ดึงประวัติกะของพนักงาน

ดึงรายการกะที่พนักงานคนหนึ่งเคยถูกกำหนดไว้ พร้อมวันที่ที่กะนั้นเริ่มมีผล (AsOfDate)

⚠️ ข้อควรรู้

403 ของ endpoint นี้มีได้ 2 สาเหตุ — นอกจากสิทธิ์ Open API แล้ว ผู้ใช้ที่ token ผูกอยู่ต้องมีสิทธิ์ดูข้อมูลกะของพนักงานคนนั้นในระบบหลักด้วย (เมนูข้อมูลพนักงาน) ถ้าไม่มีสิทธิ์จะได้ 403 ไม่ใช่ 204

ส่ง companyName หรือ employeeNo ที่ไม่มีอยู่จริงจะได้ 204 ไม่ใช่ 404

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

สำเร็จ — Data คือรายการกะของพนักงาน เรียงตามข้อมูลที่ระบบเก็บไว้

Bodyapplication/json

Example

{
    "StatusCode": 200,
    "Message": "OK",
    "Totals": 2,
    "Data": [
        {
            "ShiftId": 3301,
            "Code": "A01",
            "ShiftName": "กะเช้าตัวอย่าง",
            "CreatedBy": "ผู้ดูแลตัวอย่าง หนึ่ง",
            "ModifiedBy": null,
            "DateCreated": "2026-01-15T08:00:00",
            "DateModified": null,
            "AsOfDate": "2026-01-16T00:00:00",
            "Description": "กะทำงานปกติ จันทร์-ศุกร์"
        },
        {
            "ShiftId": 3302,
            "Code": "B01",
            "ShiftName": "กะบ่ายตัวอย่าง",
            "CreatedBy": "ผู้ดูแลตัวอย่าง หนึ่ง",
            "ModifiedBy": "ผู้ดูแลตัวอย่าง สอง",
            "DateCreated": "2026-05-01T09:00:00",
            "DateModified": "2026-05-02T10:30:00",
            "AsOfDate": "2026-06-01T00:00:00",
            "Description": "กะบ่าย"
        }
    ]
}

🟢204No Content

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error