Workin - Gofive OpenAPI

บันทึกเวลาเข้า-ออกงาน (work in)

บันทึกการตอกบัตรของพนักงาน 1 ครั้ง พร้อมพิกัด/จุดลงเวลา/ไฟล์แนบ
ระบบจะตรวจว่าอยู่ในรัศมีของจุดลงเวลาหรือไม่ และเป็นการเข้าหรือออกงานตามลำดับการตอกของวันนั้น

📘 WorkinType ต้องตรงกับชนิดของจุดลงเวลาที่ใช้ (ดูจุดลงเวลาที่มีได้จาก GET /api/v1/workin-sites)

1 = GPS

2 = iBeacon

3 = เครื่องสแกน (IOMO)

4 = empeo Station

5 = ทำงานที่บ้าน

6 = Wi-Fi

📥 header เสริมที่ระบบอ่านเอง — x-DeviceId (รหัสอุปกรณ์) และ User-Agent ถ้าส่งมาจะถูกบันทึกไว้กับรายการ โดยทับค่าที่ส่งใน body

📋 ต้องมีข้อมูลก่อนเรียก: จุดลงเวลาที่อ้างถึงต้องถูกตั้งค่าไว้แล้วในระบบ empeo

⚠️ ไม่สำเร็จได้ 400 เช่น อยู่นอกรัศมีที่กำหนด, ไม่พบพนักงาน หรือจุดลงเวลาไม่ถูกต้อง — เหตุผลอยู่ใน Data.message (มี message_EN คู่กันด้วย)

📎 Attachment Limit

จำนวนไฟล์แนบ (Attachments) สูงสุดต่อ 1 Request: 20 ไฟล์

หากส่งเกินจำนวนนี้ ระบบจะตอบกลับ 429 Too Many Requests โดยไม่บันทึกการลงเวลา

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

Request

Header Params

Body Params application/jsonRequired

Example

{
    "EmployeeRefId": "EMP001",
    "WorkinType": 1,
    "Latitude": 13.736717,
    "Longitude": 100.523186,
    "LocationName": "อาคารตัวอย่าง ชั้น 10",
    "Note": "เข้างานปกติ",
    "IsWorkFromHome": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

บันทึกสำเร็จ — ผลอยู่ใน Data

Bodyapplication/json

Example

{
    "Status": {
        "Code": "1000",
        "Description": "Success!"
    },
    "Data": {
        "result": true,
        "message": "บันทึกเวลาเรียบร้อย",
        "message_EN": "Saved successfully."
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error