Locations API Module

ภาพรวม (Overview)

โมดูล Locations เป็น API สำหรับดึงรายการสถานที่บันทึกเวลา (Location) ที่ลงทะเบียนในระบบ ใช้สำหรับอ้างอิง location_id เมื่อส่งข้อมูลบันทึกเวลาแบบ Checkin, QR หรือ Facial ในโมดูล Time Attendance

Location คืออะไร?

Location (สถานที่) คือพื้นที่ที่อนุญาตให้พนักงานบันทึกเวลาได้ โดยแต่ละสถานที่ประกอบด้วย:

พิกัด (ละติจูด, ลองจิจูด) และรัศมีที่ยอมรับ
ช่วงเวลาที่เปิดให้บันทึก (เริ่มต้น-สิ้นสุด)
วันในสัปดาห์ที่เปิดใช้งาน (Mon-Sun)
ภาพ QR Code สำหรับการสแกนบันทึกเวลาผ่าน Time Attendance App

API Endpoints (1 endpoint)

Get Location List

ดึงรายการสถานที่บันทึกเวลาทั้งหมด กรองตามสถานะเผยแพร่และเรียงลำดับได้

Use Cases:

ดึงรายการสถานที่เพื่อแสดงผลในระบบ
ค้นหา location_id สำหรับใช้กับ API บันทึกเวลา (Time Attendance)
กรองเฉพาะสถานที่ที่เผยแพร่แล้ว (publish_flag = Y)

Standard Response Format

Success Response


{
  "code": "200",
  "message": "Success",
  "payload": []
}

Error Response


{
  "code": "400",
  "message": "Failed",
  "errors": []
}

Response code ในโมดูลนี้เป็น string ("200", "400") ต่างจากบางโมดูลที่เป็น number

Submit Time Attendance - บันทึกเวลาโดยอ้างอิง location_id (สำหรับประเภท Checkin, QR, Facial)
Devices - อุปกรณ์บันทึกเวลาที่ผูกกับสถานที่