Cams Biometric Gateway — Web API 3.0

Cams Biometric Gateway คือ Biometric API สากลที่เชื่อมต่อเครื่องลงเวลาหรือเครื่องควบคุมการเข้าออกด้วยไบโอเมตริกซ์ ทุกรุ่นเข้ากับแอปพลิเคชันของคุณ ไม่ว่าจะเป็น ERP, HRMS, เงินเดือน, ระบบบริหารโรงเรียน, ซอฟต์แวร์ที่พัฒนาขึ้นเอง หรือเวิร์กโฟลว์ AI/ระบบอัตโนมัติ รองรับอุปกรณ์ยี่ห้อหลักทั้งหมด และให้ Biometric API แบบ JSON ผ่าน HTTP ที่เป็นมาตรฐานเดียวกัน ไม่ว่าจะใช้ฮาร์ดแวร์ใดก็ตาม

38 การทำงาน — Callback API 11 รายการ (อุปกรณ์ → เซิร์ฟเวอร์) และ RESTful API 27 รายการ (เซิร์ฟเวอร์ → อุปกรณ์) payload ทั้งหมดเป็น JSON ดิบผ่าน HTTP/HTTPS
รองรับเครื่องไบโอเมตริกซ์ทุกประเภท ทั้งเครื่อง Cams อุปกรณ์ที่ผ่านการตรวจสอบแล้ว และยี่ห้ออื่น ๆ (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC และอื่น ๆ) เลือกโหมดการเชื่อมต่อที่เหมาะกับระบบของคุณ

หลักการทำงาน

Biometric Gateway ประกอบด้วย:

Gateway Serverแพลตฟอร์มบนคลาวด์ที่ประกอบด้วย Cams Protocol Engine (แปลงโปรโตคอล ปรับข้อมูลให้เป็นมาตรฐาน แคชแบบออฟไลน์ การยืนยันตัวตน) และเลเยอร์ Standardised API ที่มอบอินเทอร์เฟซที่สม่ำเสมอให้แอปพลิเคชันของคุณ
Protocol Engineเอนจินหลักภายใน Gateway Server ที่สื่อสารกับอุปกรณ์ไบโอเมตริกซ์ แปลงโปรโตคอลเฉพาะของแต่ละผู้ผลิต และจัดการการบันทึกธุรกรรมข้อมูลอย่างปลอดภัยรวมถึงการจัดการตัวตน
Protocol Engine Liteเวอร์ชันแบบ on-premise ที่ติดตั้งบนเซิร์ฟเวอร์ของคุณเอง (Windows/Linux) สำหรับสภาพแวดล้อมที่ใช้เฉพาะ LAN หรือโฮสต์เอง ใช้ API เดียวกัน แต่ติดตั้งในเครื่อง

ผสานการทำงานกับ

OdooERPNextSAPMicrosoft Dynamics ZohoBitrix24 OrangeHRMBayZatPalmHRuKnowva FedenaTeachmintEduBricz RazorPayPayruler n8nMakeZapier Claude (MCP)GeminiChatGPT เว็บแอปที่พัฒนาเอง
แอปพลิเคชันของคุณ
ERP HRMS เงินเดือน ERP โรงเรียน เวิร์กโฟลว์ AI (n8n, Zapier) MCP — Claude · Gemini · ChatGPT แอปที่พัฒนาเอง
Biometric Gateway
Protocol Engine
การประมวลผลการยืนยันตัวตนอย่างปลอดภัย การบันทึกธุรกรรมข้อมูล การแปลงโปรโตคอล แคชและคิวออฟไลน์ (Offline Cache & Queue) การเข้ารหัส AES-256 · การตรวจสอบ Auth Token
เลเยอร์ Standardised API
การจัดการตัวตน การผสานรวม AI / MCP Callback Dispatcher REST Command Router การปรับข้อมูลให้เป็นมาตรฐาน · รองรับโปรโตคอลหลายยี่ห้อ
อินเทอร์เน็ต
ลายนิ้วมือ · การจดจำใบหน้า · เส้นเลือดฝ่ามือ · บัตร RFID · PIN · QR / บาร์โค้ด · การติดตาม GPS
อุปกรณ์ไบโอเมตริกซ์ — รองรับทุกยี่ห้อ
Cams ZKTeco Suprema Hikvision Anviz Morpho / IDEMIA Virdi Mantra Nitgen Realtime Biomax Secugen eSSL Matrix + ยี่ห้ออื่น ๆ อีกมากมาย
ประเภท APIทิศทางความหน่วงกรณีการใช้งาน
Callback APIอุปกรณ์ → เซิร์ฟเวอร์ของคุณเรียลไทม์ / ไม่มีความหน่วงรับข้อมูลการลงเวลา และเหตุการณ์ซิงค์ผู้ใช้
RESTful APIเซิร์ฟเวอร์ของคุณ → อุปกรณ์~15 วินาทีเพิ่ม/ลบผู้ใช้ ดึง log ลงทะเบียนไบโอเมตริกซ์

เริ่มต้นใช้งาน

เชื่อมต่อได้ในสามขั้นตอน เซิร์ฟเวอร์ของคุณต้องมี URL ที่เข้าถึงได้จากสาธารณะเพื่อรับ callback

1

กำหนดค่า Callback URL

เข้าสู่ระบบพอร์ทัล API Monitor ตั้งค่า URL HTTPS สาธารณะของเซิร์ฟเวอร์คุณเป็น Callback URL สำหรับอุปกรณ์ของคุณ API engine จะ POST เหตุการณ์ไบโอเมตริกซ์ไปยัง endpoint นี้แบบเรียลไทม์

2

รับข้อมูลการลงเวลา

endpoint ของคุณจะได้รับ POST ที่มี body เป็น JSON ดิบ — Callback API ไม่ต้องใช้ query parameter ให้ตรวจสอบ AuthToken แยกวิเคราะห์ข้อมูลการลงเวลา และตอบกลับด้วย {"status":"done"}

3

เรียก RESTful API เพื่อจัดการผู้ใช้และอุปกรณ์

POST คำสั่ง JSON ไปยัง URL endpoint ของ RESTful ที่อยู่ในบัญชี API Monitor ของคุณ พร้อม stgid (Service Tag ID) เป็น query parameter engine จะจัดคิวคำสั่งและอุปกรณ์จะตอบรับภายในประมาณ ~15 วินาที

รูปแบบ Endpoint

ประเภท APIเมธอดวิธีส่ง
Callback API (ขาเข้า) POST อุปกรณ์ POST ไปยัง URL ที่ คุณ กำหนดไว้ body เป็น JSON ดิบ ไม่มีพารามิเตอร์
RESTful API (ขาออก) POST คุณ POST ไปยัง URL endpoint ของ RESTful (อยู่ในบัญชี API Monitor ของคุณ) พร้อม ?stgid=YOUR_SERVICE_TAG_ID และ body เป็น JSON ดิบ
ตอบกลับคำขอ Callback ทันทีเสมอ เซิร์ฟเวอร์ของคุณต้องส่งกลับ {"status":"done"} (HTTP 200) เพื่อยืนยันว่าได้รับแล้ว อย่าประมวลผลหนัก ๆ ก่อนตอบกลับ — ให้ใส่คิวไว้

เอกสาร API

เอกสารอ้างอิงแบ่งตามหัวข้อ เริ่มจากความเข้ากันได้ของอุปกรณ์ แล้วต่อด้วยการทำงานของ callback และ REST

อุปกรณ์ที่รองรับและโหมดการเชื่อมต่อเครื่องใดบ้างที่ Gateway รองรับ แต่ละเครื่องเชื่อมต่ออย่างไร (Native Push หรือ Hybrid Push) และมี API ใดใช้ได้ในแต่ละโหมด เอกสารอ้างอิง API: สถาปัตยกรรม ฟิลด์ และรหัสสถานะองค์ประกอบพื้นฐานที่ทุกการทำงานใช้ร่วมกัน: ลำดับการส่งคำขอ ฟิลด์ JSON ทั่วไป ประเภทเทมเพลต รหัสสถานะ พอร์ต และการเข้ารหัส payload Callback API: เหตุการณ์แบบเรียลไทม์จากอุปกรณ์ไปยังเซิร์ฟเวอร์ของคุณทุกเหตุการณ์ที่อุปกรณ์ส่งไปยัง callback URL ของคุณ พร้อม JSON ที่เซิร์ฟเวอร์ได้รับและการตอบกลับที่ต้องส่งคืน RESTful API: คำสั่งจากเซิร์ฟเวอร์ของคุณไปยังอุปกรณ์คำสั่งที่เซิร์ฟเวอร์ของคุณส่งไปยังอุปกรณ์ผ่าน Gateway พร้อม JSON คำขอและการตอบกลับของแต่ละคำสั่ง ทดสอบ API ในเครื่องวิธีรับ callback จากอุปกรณ์บนเครื่องที่ใช้พัฒนา และทดสอบคำสั่ง REST ด้วย Postman ก่อนนำขึ้นใช้งานจริง ตัวอย่าง PHP: จัดเก็บข้อมูลการลงเวลาไบโอเมตริกซ์ใน MySQLตัวอย่างตัวจัดการ callback ด้วย PHP ที่ใช้งานได้จริง บันทึกข้อมูลการลงเวลาลงใน MySQL ภายในสามขั้นตอน พรอมต์สร้างโค้ดด้วย AIคัดลอกพรอมต์ไปยังผู้ช่วย AI ของคุณเพื่อสร้างโค้ดเชื่อมต่อสำหรับสแต็กของคุณเอง FAQ, SDK และค่าใช้จ่ายคำถามที่พบบ่อยจากผู้เชื่อมต่อระบบ รวมถึงวิธีทำงานของ SDK และการคิดราคา API

ติดต่อเรา

สำหรับการสนับสนุนด้าน API ความเข้ากันได้ของอุปกรณ์ หรือสอบถามฝ่ายขาย:

ฝ่ายขายและฝ่ายสนับสนุน

WhatsApp+91-98-409-21006 (ฝ่ายสนับสนุน)
ฝ่ายขาย+91-98-409-41006

แหล่งข้อมูลสำหรับนักพัฒนา

อุปกรณ์developer.camsbiometrics.com
ผลิตภัณฑ์camsbiometrics.com/product

Cams Biometrics (Dheeram Innovations Pvt Ltd) — No: 2/98D, 2nd Floor, Cams Biometrics Building, Opposite to Satyabama University, Semmancheri, OMR, Chennai – 600119, India.