ยืนยันตัวตน ดึงข้อมูลการลงเวลา ลงทะเบียนลายนิ้วมือ และเปิดประตู — พร้อมตัวอย่างให้คัดลอกวางในภาษาที่คุณใช้อยู่แล้ว
เริ่มต้นใช้งานด่วน
สร้างบัญชีบนพอร์ทัลนักพัฒนาและจับคู่อุปกรณ์ด้วยหมายเลขซีเรียล คุณจะได้รับ AuthToken
ส่ง AuthToken ไปกับทุกการเรียก ซึ่งจำกัดขอบเขตการเข้าถึงตามบัญชีและอุปกรณ์เฉพาะของคุณ
เริ่มด้วย GetAttendanceByDate เพื่อยืนยันว่าข้อมูลไหลเข้ามา แล้วไปต่อที่การลงทะเบียนและการควบคุมการเข้าถึง
https://api.camsbiometrics.com/v3/
# Fetch attendance for a date range curl https://api.camsbiometrics.com/v3/attendance/getbyscandate \ -d "AuthToken=$API_KEY" \ -d "StartDate=2026-06-01" \ -d "EndDate=2026-06-21"
$ch = curl_init("https://api.camsbiometrics.com/v3/attendance/getbyscandate"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => [ "AuthToken" => $apiKey, "StartDate" => "2026-06-01", "EndDate" => "2026-06-21", ], ]); $data = json_decode(curl_exec($ch), true);
import requests r = requests.post( "https://api.camsbiometrics.com/v3/attendance/getbyscandate", data={ "AuthToken": api_key, "StartDate": "2026-06-01", "EndDate": "2026-06-21", }, ) logs = r.json()["Attendance"]
const res = await fetch( "https://api.camsbiometrics.com/v3/attendance/getbyscandate", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ AuthToken: apiKey, StartDate: "2026-06-01", EndDate: "2026-06-21", }), } ); const { Attendance } = await res.json();
รูปแบบเดียวกันใช้ได้กับทุกการดำเนินการ — เปลี่ยนเพียง path และพารามิเตอร์
สูตรที่ใช้บ่อย
curl .../v3/user/add \ -d "AuthToken=$K" \ -d "DeviceSN=ZK6A2300583" \ -d "EmployeeCode=1042" \ -d "Name=Priya"
curl .../v3/access/opendoor \ -d "AuthToken=$K" \ -d "DeviceSN=ZK6A2300583" \ -d "DoorNo=1"
curl .../v3/callback/register \ -d "AuthToken=$K" \ -d "Url=https://app/hook" \ -d "Events=attendance.new"
ห้ามฝัง AuthToken ในโค้ดฝั่งไคลเอนต์ ให้เรียกผ่านพร็อกซีที่แบ็กเอนด์ของคุณ
เกตเวย์จะลองใหม่จนกว่าคุณจะตอบกลับ 200 ให้ตัดข้อมูลซ้ำโดยอ้างอิง event id เพื่อให้การลองใหม่ปลอดภัย
หากอุปกรณ์ออฟไลน์ คุณจะได้รับ 409 คำสั่งจะถูกจัดคิวไว้ โพลล์ GetCommandStatus
การทดสอบในเครื่อง
เครื่องพัฒนาของคุณอยู่หลังไฟร์วอลล์ เกตเวย์จึงเข้าถึง localhost โดยตรงไม่ได้ ให้เปิดเผยด้วยทันเนล ชี้ Callback URL ของคุณไปยังที่อยู่สาธารณะ แล้วทริกเกอร์การลงเวลาทดสอบ
200# 1. install & authenticate ngrok ngrok config add-authtoken $TOKEN # 2. expose your local app (e.g. port 3000) ngrok http 3000 # Forwarding https://abc123.ngrok-free.app -> localhost:3000 # 3. set that HTTPS URL as your Callback URL
# Cams ngrok helper kit (Windows) # download: developer.camsbiometrics.com/setup/ngrok-helper-kit.rar # then: edit app.properties # add your ngrok authtoken run check_ngrok.bat
เชื่อมต่ออุปกรณ์
เทอร์มินัลลงเวลาส่วนใหญ่ (ZKTeco, eSSL และรุ่นที่เข้ากันได้) ใช้โปรโตคอล ICLOCK / push ตั้งค่าช่อง cloud-server บนอุปกรณ์ แล้วอุปกรณ์จะสตรีมข้อมูลการลงเวลาเข้าบัญชีของคุณ — ไม่ต้องใช้พีซีหรือซอฟต์แวร์ภายในเครื่อง
ตั้งค่า IP / subnet / เกตเวย์ / DNS ของอุปกรณ์ให้ตรงกับ LAN ของคุณ (หรือใช้ DHCP) ก่อนตั้งค่า cloud server
จับคู่บนพอร์ทัลนักพัฒนาแล้วเรียกใช้งานจริงได้ในไม่กี่นาที
เราใช้คุกกี้เพื่อวัดปริมาณการเข้าชมและปรับปรุง BiometricAPI.com การวิเคราะห์จะปิดอยู่จนกว่าคุณจะยอมรับ ดูเพิ่มเติม