สัญญาเดียวสำหรับทุกอุปกรณ์ 38 การดำเนินการใน 5 กลุ่มความสามารถ ใช้ได้ทั้งการเรียก REST แบบซิงโครนัสและ webhook Callback แบบเรียลไทม์
การเรียก REST ทั้งหมดส่งไปยังโฮสต์เดียวที่มีเวอร์ชันกำกับ
https://api.camsbiometrics.com/v3/
ทุกคำขอต้องแนบ AuthToken ที่จำกัดขอบเขตตามบัญชีและอุปกรณ์ของคุณ คีย์ออกให้จากพอร์ทัลนักพัฒนา
คำขอแบบ form-encoded หรือ JSON การตอบกลับเป็น JSON พร้อมฟิลด์และรหัสข้อผิดพลาดที่คาดเดาได้
สองวิธีในการผสานรวม
คุณเรียกเกตเวย์แล้วได้คำตอบทันที เหมาะสำหรับดึงข้อมูลการลงเวลา แสดงรายการผู้ใช้ ลงทะเบียนบุคคล หรือเปิดประตูตามต้องการ
ลงทะเบียน URL แล้วเกตเวย์จะพุชอีเวนต์มาให้ทันทีที่อุปกรณ์รายงาน — ไม่ต้องโพลล์ พร้อมการลองใหม่อัตโนมัติเมื่อล้มเหลว
การดำเนินการ
จัดกลุ่มตามหน้าที่ ชื่อสอดคล้อง 1:1 กับ endpoint ของเกตเวย์เบื้องหลัง
การลงเวลาทั้งหมดภายในช่วงวันที่ของทั้งบัญชี
ล็อกของรหัสพนักงานหนึ่งคนตลอดช่วงเวลาที่กำหนด
การลงเวลาที่บันทึกโดยอุปกรณ์หนึ่งหมายเลขซีเรียล
สรุปรายวันรายพนักงาน (เข้า/ออก ชั่วโมง)
คู่เข้าแรก / ออกหลังสุดต่อพนักงานต่อวัน
ภาพรวมสดของการลงเวลาในวันนี้
ภาพถ่ายที่แนบกับการลงเวลา สำหรับอุปกรณ์ที่รองรับ
ส่งออกเป็นชุดสำหรับเงินเดือนและการกระทบยอด
สร้างผู้ใช้บนอุปกรณ์หนึ่งเครื่องหรือมากกว่า
แก้ไขชื่อ บทบาท ระยะเวลาที่ใช้ได้ หรือสิทธิ์
ลบผู้ใช้ออกจากอุปกรณ์
ค้นหาผู้ใช้ด้วยรหัส พร้อมข้อมูลประจำตัวแบบเลือกได้
แสดงรายการทุกคนที่ลงทะเบียนบนอุปกรณ์
แสดงว่าผู้ใช้มีอยู่บนอุปกรณ์เครื่องใดบ้าง
พุชเทมเพลตลายนิ้วมือไปยังอุปกรณ์
ลงทะเบียนเทมเพลตใบหน้า สำหรับอุปกรณ์ที่รองรับ
กำหนดบัตร RFID / บัตรใกล้ให้ผู้ใช้
ตั้งหรือเปลี่ยน PIN / รหัสผ่านของอุปกรณ์
คัดลอกผู้ใช้และเทมเพลตระหว่างอุปกรณ์
ส่งข้อมูลของผู้ใช้ไปยังคิวของอุปกรณ์อีกครั้ง
สั่งรีเลย์ประตู ประตูหมุน แฟลป สวิง หรือไม้กั้นบูมแบบเรียลไทม์
ล็อก / ค้างประตูไว้ภายใต้การควบคุมของคุณ
อ่านสถานะเปิด / ปิดปัจจุบัน
กำหนดช่วงเวลาการเข้าถึงตามเวลา
ล็อกอีเวนต์เข้า / ออกและประตู
รายการอุปกรณ์ที่เชื่อมต่อทั้งหมด
รุ่น เฟิร์มแวร์ ความจุ และตัวนับ
สถานะออนไลน์ เวลาที่พบล่าสุด และความลึกของคิว
ยืนยันว่าเข้าถึงอุปกรณ์ได้ในขณะนี้
ปรับนาฬิกาของอุปกรณ์ให้ตรงกับเซิร์ฟเวอร์
รีสตาร์ทอุปกรณ์จากระยะไกล
ล้างคำสั่งที่ค้างออกจากคิว
ติดตามสถานะของคำสั่งที่อยู่ในคิว
สมัครรับ webhook URL สำหรับอีเวนต์สด
ทริกเกอร์ทุกครั้งที่มีการลงเวลา แบบเรียลไทม์
การเปลี่ยนสถานะออนไลน์ / ออฟไลน์และสถานะการทำงาน
การยืนยันเมื่อเทมเพลตถูกส่งถึงอุปกรณ์
ติดตามความคืบหน้าการย้ายอุปกรณ์ / ข้อมูลเป็นชุด
การตอบกลับที่คาดเดาได้
| รหัส | ความหมาย | สิ่งที่ควรทำ |
|---|---|---|
200 | สำเร็จ | ประมวลผล JSON payload |
401 | AuthToken ไม่ถูกต้องหรือไม่มี | ตรวจสอบ API key และการจับคู่อุปกรณ์ |
404 | ไม่พบอุปกรณ์หรือผู้ใช้ | ตรวจสอบหมายเลขซีเรียล / รหัสพนักงาน |
409 | อุปกรณ์ออฟไลน์ / อยู่ในคิว | คำสั่งอยู่ในคิว โพลล์ GetCommandStatus |
429 | ถูกจำกัดอัตรา | ถอยกลับแล้วลองใหม่โดยสุ่มหน่วงเวลา (jitter) |
คู่มือเริ่มต้นใช้งานด่วนพาคุณจาก API key ไปสู่ล็อกการลงเวลาแรกในเวลาไม่กี่นาที
เราใช้คุกกี้เพื่อวัดปริมาณการเข้าชมและปรับปรุง BiometricAPI.com การวิเคราะห์จะปิดอยู่จนกว่าคุณจะยอมรับ ดูเพิ่มเติม