ElogTime API

API ระบบลงเวลา ElogTime

API สำหรับนักพัฒนาระบบ ใช้เชื่อมต่อและดึงข้อมูลการลงเวลาพนักงาน จากระบบ ElogTime เพื่อนำไปใช้งานต่อในระบบ HR, Payroll, ERP และ Software ขององค์กร

ElogTime API สำหรับนักพัฒนาคืออะไร?

ElogTime API เป็นช่องทางสำหรับให้นักพัฒนาสามารถ เชื่อมต่อข้อมูลการลงเวลาพนักงานจากระบบ ElogTime ไปยังโปรแกรมหรือระบบอื่นได้

นักพัฒนาสามารถนำข้อมูลไปใช้สำหรับสร้างระบบ HR, Payroll, ERP, โปรแกรมเงินเดือน, Dashboard, ระบบรายงาน หรือระบบบริหารเวลาทำงาน ที่พัฒนาขึ้นเอง

ระบบ ElogTime รองรับการจัดการข้อมูล Time Attendance จากเครื่องสแกนลายนิ้วมือ เครื่องสแกนใบหน้า เครื่องทาบบัตร และระบบลงเวลาที่เชื่อมต่อกับระบบ โดยข้อมูลสามารถนำไปประมวลผลต่อในระบบออนไลน์ได้

API Endpoint

Endpoint สำหรับเรียกข้อมูลการลงเวลาพนักงาน

GET https://www.elogtime.com/api/getatt

ตัวอย่าง API Request

https://www.elogtime.com/api/getatt?sn=COVP243460031&date_start=2025-11-18&date_end=2025-11-18

Request Parameters

Parameter Type Required รายละเอียด ตัวอย่าง
sn String Yes Serial Number ของเครื่องลงเวลา COVP243460031
date_start Date Yes วันที่เริ่มต้นที่ต้องการดึงข้อมูล 2025-11-18
date_end Date Yes วันที่สิ้นสุดที่ต้องการดึงข้อมูล 2025-11-18

ตัวอย่างการเรียก API ด้วย cURL

curl "https://www.elogtime.com/api/getatt?sn=COVP243460031&date_start=2025-11-18&date_end=2025-11-18"

ตัวอย่างการเรียก API ด้วย C#

ตัวอย่างสำหรับระบบ ASP.NET Core, .NET และ C#

using var client = new HttpClient();

var url =
    "https://www.elogtime.com/api/getatt" +
    "?sn=COVP243460031" +
    "&date_start=2025-11-18" +
    "&date_end=2025-11-18";

var response = await client.GetAsync(url);

response.EnsureSuccessStatusCode();

var json = await response.Content.ReadAsStringAsync();

ตัวอย่างการเรียก API ด้วย JavaScript

const url =
    "https://www.elogtime.com/api/getatt" +
    "?sn=COVP243460031" +
    "&date_start=2025-11-18" +
    "&date_end=2025-11-18";

fetch(url)
    .then(response => response.json())
    .then(data => {
        console.log(data);
    });

API Response

API จะส่งข้อมูลกลับมาในรูปแบบ JSON เพื่อให้นักพัฒนาสามารถนำข้อมูลไปประมวลผลต่อได้ง่าย

{
  "success": true,
  "sn": "COVP243460031",
  "date_start": "2025-11-18",
  "date_end": "2025-11-18",
  "count": 46,
  "data": [
    {
      "id": 5139064,
      "devSN": "COVP243460031",
      "time": "2025-11-18T05:02:24",
      "pin": "19",
      "cardNo": null,
      "eventAddr": null,
      "event": 0,
      "inOutStatus": 0,
      "verifyType": 4
    }
  ]
}

Response Fields

Field Type รายละเอียด
success Boolean สถานะการเรียก API
sn String Serial Number ของเครื่อง
date_start Date วันที่เริ่มต้น
date_end Date วันที่สิ้นสุด
count Integer จำนวนรายการข้อมูลที่พบ
data Array รายการข้อมูลการลงเวลา
id Integer รหัสรายการลงเวลา
devSN String Serial Number ของอุปกรณ์
time DateTime วันและเวลาที่เกิดรายการลงเวลา
pin String รหัสพนักงานหรือ PIN ที่ใช้ลงเวลา
cardNo String / Null หมายเลขบัตร หากรายการลงเวลาด้วยบัตร
eventAddr String / Null ข้อมูล Event Address หากมี
event Integer รหัส Event จากอุปกรณ์
inOutStatus Integer สถานะการเข้า–ออกของรายการ
verifyType Integer ประเภทวิธีการยืนยันตัวตน

API ทำงานอย่างไร?

01

ระบุ Serial Number

ระบุ Serial Number ของเครื่องที่ต้องการดึงข้อมูล

02

กำหนดวันที่

กำหนดวันที่เริ่มต้น และวันที่สิ้นสุด

03

เรียก API

ส่ง HTTP GET Request ไปยัง ElogTime API

04

รับ JSON

นำข้อมูล JSON ไปประมวลผลในระบบของคุณ

นำ API ไปใช้กับระบบอะไรได้บ้าง?

ระบบ HR

ดึงข้อมูลเวลาเข้า–ออก เพื่อนำไปคำนวณเวลาทำงาน ขาด ลา มาสาย และ OT

ระบบ Payroll

นำข้อมูลการลงเวลาไปคำนวณ เงินเดือน ค่าล่วงเวลา และค่าจ้าง

ERP

เชื่อมข้อมูล Time Attendance เข้ากับระบบ ERP ขององค์กร

Custom Software

สำหรับนักพัฒนาที่ต้องการสร้าง Dashboard หรือระบบบริหารเวลาเฉพาะองค์กร

คำแนะนำสำหรับนักพัฒนา

  • ตรวจสอบ HTTP Status Code ก่อนประมวลผลข้อมูล
  • ตรวจสอบค่า success ก่อนนำข้อมูลใน data ไปใช้งาน
  • รองรับกรณีที่ data ไม่มีรายการข้อมูล
  • ควรจัดการกรณี API ไม่สามารถเชื่อมต่อได้
  • ควรเก็บ Log การเรียก API เพื่อช่วยตรวจสอบปัญหาในการเชื่อมต่อ
  • ควรป้องกัน Serial Number และข้อมูลการลงเวลาของพนักงาน ไม่ให้เผยแพร่ต่อสาธารณะ

FAQ สำหรับนักพัฒนา

ElogTime API คือ API สำหรับเชื่อมต่อข้อมูลการลงเวลาพนักงาน จากระบบ ElogTime ไปยังระบบภายนอก เช่น HR, Payroll, ERP และ Custom Software

API ใช้ sn, date_start และ date_end เป็น Parameters สำหรับระบุเครื่อง และช่วงวันที่ที่ต้องการดึงข้อมูล

JSON สามารถนำไปใช้งานกับภาษาและ Framework ที่รองรับ HTTP และ JSON ได้ เช่น C#, ASP.NET Core, PHP, JavaScript, Node.js, Python, Java และอื่น ๆ

ได้ โดยสามารถนำข้อมูลการลงเวลา ไปประมวลผลต่อในระบบ Payroll เพื่อคำนวณเวลาทำงาน OT และข้อมูลที่เกี่ยวข้องกับเงินเดือนได้

⚠️ ข้อควรระวังด้านข้อมูล

ข้อมูลการลงเวลาพนักงานอาจเกี่ยวข้องกับข้อมูล ของบุคคลและข้อมูลการทำงานขององค์กร นักพัฒนาควรควบคุมการเข้าถึง API และไม่ควรเผยแพร่ URL หรือข้อมูลการลงเวลา ให้บุคคลที่ไม่มีสิทธิ์เข้าถึง

ต้องการเชื่อมต่อ ElogTime API?

หากต้องการนำข้อมูล Time Attendance ไปเชื่อมต่อกับระบบ HR, Payroll, ERP หรือระบบที่พัฒนาขึ้นเอง สามารถติดต่อ FingerThailand เพื่อสอบถามรายละเอียดการเชื่อมต่อระบบ

ติดต่อ FingerThailand