หน้าแรก / ผลิตภัณฑ์ / API / Biometric Gateway Web API

API

Biometric Gateway Web API

Biometric Gateway Web API (หรือ Universal Biometric Web API 3.0) เปลี่ยนอุปกรณ์ลายนิ้วมือ ใบหน้า ฝ่ามือ เส้นเลือด ม่านตา จอตา บัตร หรือรหัสผ่านที่รองรับให้เป็น endpoint ที่เชื่อมต่อคลาวด์ ซึ่งแอปพลิเคชันของคุณสื่อสารด้วยได้จากทุกที่ในโลก รับการลงเวลาแบบเรียลไทม์ทันทีที่เกิดขึ้น และจัดการผู้ใช้บนอุปกรณ์จากระยะไกล ทั้งหมดผ่านสัญญา REST พร้อม Callback แบบง่าย

เริ่มต้นใช้งาน เอกสารสำหรับนักพัฒนา

ภาพรวม

เชื่อมต่ออุปกรณ์ลงเวลาหรือควบคุมการเข้าถึงด้วยไบโอเมตริกที่ต่ออินเทอร์เน็ตได้เข้ากับเว็บแอปพลิเคชันของคุณโดยตรงผ่าน HTTP — ไม่ต้องใช้ซอฟต์แวร์ พีซี หรือฐานข้อมูลภายในเครื่อง

Web API ตัวเรือธงของ Cams ทำให้อุปกรณ์ไบโอเมตริกที่ติดตั้งในระยะไกลสื่อสารกับแอปพลิเคชันเซิร์ฟเวอร์ของคุณแบบเครื่องต่อเซิร์ฟเวอร์ได้ อุปกรณ์เชื่อมต่ออินเทอร์เน็ต การลงเวลาถูกพุชไปยัง Callback (webhook) URL ของคุณแบบเรียลไทม์ และเซิร์ฟเวอร์ของคุณสั่งการอุปกรณ์ เช่น เพิ่มหรือลบผู้ใช้ พุชเทมเพลต พุชภาพถ่าย และโหลดล็อกการลงเวลา ผ่านการเรียก RESTful ไม่ต้องติดตั้งซอฟต์แวร์เดสก์ท็อป รันฐานข้อมูลภายในเครื่อง หรือเปิดพีซีค้างไว้ใน LAN API ไม่ผูกกับฐานข้อมูลและใช้ได้กับแบ็กเอนด์ทุกภาษา

APIRESTCallback/Webhook (HTTP POST)MQTT (เส้นทางการเชื่อมต่อถาวร EMQX)PHPPythonJavaNode.js

ใช้ใน:การจัดการผู้มาเยือน อีเวนต์ เทศกาล และสนามกีฬา

Callback (webhook) — การลงเวลาแบบเรียลไทม์

# Your Callback URL receives every punch in real time
POST https://yourapp.com/cams/callback
{
  "DeviceSN": "SN7A2300583",
  "EmployeeCode": "1042",
  "AttendanceLog": "2026-06-21 09:02:14",
  "Type": "face",
  "Direction": "CheckIn"
}

ความสามารถ

ทำอะไรได้บ้าง

การลงเวลาแบบเรียลไทม์

การลงเวลาถูกพุชไปยัง Callback URL ของคุณทันทีที่บันทึกบนอุปกรณ์

การจัดการผู้ใช้จากระยะไกล

เพิ่ม ลบ บล็อก และย้ายผู้ใช้ รวมถึงพุชเทมเพลตหรือภาพถ่ายไปยังอุปกรณ์จากเซิร์ฟเวอร์ของคุณผ่านการเรียก RESTful

การสแกนหลายรูปแบบ

สัญญาเดียวรองรับอินพุตลายนิ้วมือ ใบหน้า ฝ่ามือ เส้นเลือด ม่านตา จอตา บัตร และรหัสผ่าน

ทนต่อการออฟไลน์

การลงเวลาขณะออฟไลน์ถูกเก็บในบัฟเฟอร์บนอุปกรณ์และส่งซ้ำตามลำดับเมื่อกลับมาเชื่อมต่อ

ทรานสปอร์ตที่เข้ารหัส

เปิดใช้การเข้ารหัสข้อมูลดิบ AES-256 รายอุปกรณ์ได้เพื่อแลกเปลี่ยนข้อมูลอย่างปลอดภัย

คุณสมบัติ

รวมทุกอย่างไว้ให้

Callback (webhook) API ส่งการลงเวลาแบบเรียลไทม์จากอุปกรณ์ไปยังเซิร์ฟเวอร์ของคุณโดยไม่มีความหน่วงจากการโพลล์
RESTful API สำหรับการดำเนินการจากเซิร์ฟเวอร์ไปอุปกรณ์: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog และอื่น ๆ (38 การดำเนินการ)
บันทึกอินพุตหลายประเภทต่อการลงเวลา: ลายนิ้วมือ ใบหน้า บัตร ฝ่ามือ เส้นเลือดนิ้ว ม่านตา จอตา รหัสผ่าน รวมถึงแฟลกอุณหภูมิร่างกายและหน้ากากอนามัยหากฮาร์ดแวร์รองรับ
ประเภทการลงเวลารวม CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
จัดการการลงเวลาขณะออฟไลน์: ข้อมูลที่เข้าคิวจะถูกส่งตามลำดับเมื่ออุปกรณ์เชื่อมต่อใหม่
การเข้ารหัส AES-256 ของข้อมูลดิบที่แลกเปลี่ยนทั้งหมดแบบเลือกได้ โดยใช้ security key ที่ตั้งใน API Monitor
LoadLog API ให้แอปพลิเคชันที่ไม่ใช่เซิร์ฟเวอร์และแอปพลิเคชันเฉพาะ LAN ดึงประวัติการลงเวลาย้อนหลังได้สูงสุด 30 วันตามต้องการ
รหัสสถานะที่มีเอกสารสำหรับการจัดการข้อผิดพลาดที่แข็งแกร่ง พร้อม AuthToken รายอุปกรณ์และการติดตาม OperationID สำหรับงานสนับสนุนและการกระทบยอด

สร้างด้วย Biometric Gateway Web API

รับคีย์ อ่านเอกสาร แล้วส่งมอบ ทีมของเราช่วยดูแลการผสานรวมครั้งแรกของคุณ

คุยกับวิศวกร WhatsApp

คำถามที่พบบ่อย

ต้องติดตั้งซอฟต์แวร์ใด ๆ บนเครือข่ายภายในเพื่อใช้ Web API หรือไม่

ไม่ต้อง การสื่อสารเกิดผ่าน HTTP ระหว่างอุปกรณ์กับเซิร์ฟเวอร์ของคุณ ตราบใดที่อุปกรณ์เชื่อมต่ออินเทอร์เน็ต คุณก็รับข้อมูลการลงเวลาและจัดการผู้ใช้ได้โดยไม่ต้องมีซอฟต์แวร์ ฐานข้อมูล หรือพีซีภายในเครื่อง

Web API รองรับอินพุตไบโอเมตริกแบบใดบ้าง

ลายนิ้วมือ ใบหน้า บัตร ฝ่ามือ เส้นเลือดนิ้ว ม่านตา จอตา และรหัสผ่าน รวมถึงข้อมูลอุณหภูมิร่างกายและหน้ากากอนามัยหากฮาร์ดแวร์รองรับ

Callback API ต่างจาก RESTful API อย่างไร

Callback API คือการสื่อสารแบบเรียลไทม์จากอุปกรณ์ไปยังเซิร์ฟเวอร์ผ่าน URL ที่คุณเปิดไว้บนเซิร์ฟเวอร์ (ไม่มีความหน่วง) ส่วน RESTful API คือการสื่อสารจากเซิร์ฟเวอร์ไปยังอุปกรณ์ที่คุณเรียกที่ endpoint ของ Cams เพื่อจัดการอุปกรณ์ โดยมีความหน่วงได้สูงสุดราว 15 วินาที

ใช้ API ได้หรือไม่หากเซิร์ฟเวอร์ไม่มี IP สาธารณะ

ได้ ใช้ LoadLog API เพื่อดึงล็อกการลงเวลาในช่วงเวลาที่กำหนดตามต้องการ ตราบใดที่อุปกรณ์เชื่อมต่ออินเทอร์เน็ต