Trang chủ / Sản phẩm / API / Biometric Gateway Web API
API

Biometric Gateway Web API

Biometric Gateway Web API (còn gọi là Universal Biometric Web API 3.0) biến mọi thiết bị vân tay, khuôn mặt, lòng bàn tay, tĩnh mạch, mống mắt, võng mạc, thẻ hoặc mật khẩu được hỗ trợ thành một endpoint kết nối đám mây mà ứng dụng của bạn có thể giao tiếp từ bất cứ đâu trên thế giới. Nhận các lượt chấm công thời gian thực ngay khi chúng xảy ra và quản lý người dùng trên thiết bị từ xa, tất cả qua một hợp đồng REST cộng Callback đơn giản.

Tổng quan

Kết nối trực tiếp mọi thiết bị chấm công hoặc kiểm soát ra vào sinh trắc học có internet với ứng dụng web của bạn qua HTTP — không cần phần mềm cục bộ, PC hay cơ sở dữ liệu.

Web API chủ lực của Cams cho phép giao tiếp máy-với-máy chủ giữa các thiết bị sinh trắc học lắp đặt từ xa và ứng dụng máy chủ của bạn. Thiết bị kết nối internet, dữ liệu chấm công được đẩy đến Callback URL (webhook) của bạn theo thời gian thực, và máy chủ của bạn điều khiển các thao tác thiết bị như thêm hoặc xóa người dùng, đẩy mẫu, đẩy ảnh và tải log chấm công thông qua các lệnh gọi RESTful. Không cần cài phần mềm máy tính, chạy cơ sở dữ liệu cục bộ hay duy trì PC trong mạng LAN. API không phụ thuộc cơ sở dữ liệu và hoạt động với mọi ngôn ngữ backend.

APIRESTCallback/Webhook (HTTP POST)MQTT (đường dẫn kết nối bền vững EMQX)PHPPythonJavaNode.js
Callback (webhook) — lượt chấm công thời gian thực
# 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"
}

Khả năng

Nó làm được gì

Chấm công thời gian thực

Các lượt chấm công được đẩy đến Callback URL của bạn ngay khi được ghi nhận trên thiết bị.

Quản lý người dùng từ xa

Thêm, xóa, chặn và chuyển người dùng, đồng thời đẩy mẫu hoặc ảnh đến thiết bị từ máy chủ của bạn qua các lệnh gọi RESTful.

Thu nhận đa phương thức

Một hợp đồng xử lý đầu vào vân tay, khuôn mặt, lòng bàn tay, tĩnh mạch, mống mắt, võng mạc, thẻ và mật khẩu.

Khả năng chịu ngoại tuyến

Các lượt chấm công ngoại tuyến được lưu đệm trên thiết bị và phát lại theo thứ tự khi kết nối được khôi phục.

Truyền tải được mã hóa

Có thể bật mã hóa dữ liệu thô AES-256 theo từng thiết bị để trao đổi dữ liệu an toàn.

Tính năng

Tất cả đều có sẵn

  • Callback (webhook) API chuyển các lượt chấm công thời gian thực từ thiết bị đến máy chủ của bạn mà không có độ trễ polling
  • RESTful API cho các thao tác từ máy chủ đến thiết bị: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog và nhiều hơn nữa (38 thao tác)
  • Thu nhận nhiều loại đầu vào trên mỗi lượt chấm công: Vân tay, Khuôn mặt, Thẻ, Lòng bàn tay, Tĩnh mạch ngón tay, Mống mắt, Võng mạc, Mật khẩu, cùng các cờ Nhiệt độ cơ thể và Khẩu trang nếu phần cứng hỗ trợ
  • Các loại lượt chấm công gồm CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
  • Xử lý các lượt chấm công ngoại tuyến: dữ liệu trong hàng đợi được truyền theo thứ tự khi thiết bị kết nối lại
  • Mã hóa AES-256 tùy chọn cho toàn bộ dữ liệu thô được trao đổi, dùng khóa bảo mật đặt trong API Monitor
  • LoadLog API cho phép các ứng dụng không có máy chủ và chỉ dùng LAN lấy tới 30 ngày lịch sử chấm công theo yêu cầu
  • Mã trạng thái có tài liệu để xử lý lỗi vững chắc, cùng truy vết AuthToken theo từng thiết bị và OperationID phục vụ hỗ trợ và đối soát

Xây dựng với Biometric Gateway Web API

Lấy khóa, đọc tài liệu và triển khai. Đội ngũ của chúng tôi hỗ trợ bạn trong lần tích hợp đầu tiên.

Câu hỏi thường gặp

Câu hỏi thường gặp

Tôi có cần cài phần mềm nào trong mạng cục bộ để dùng Web API không?

Không. Việc giao tiếp diễn ra qua HTTP giữa thiết bị và máy chủ của bạn. Miễn là thiết bị được kết nối internet, bạn có thể nhận dữ liệu chấm công và quản lý người dùng mà không cần phần mềm cục bộ, cơ sở dữ liệu hay PC.

Web API hỗ trợ những đầu vào sinh trắc học nào?

Vân tay, Khuôn mặt, Thẻ, Lòng bàn tay, Tĩnh mạch ngón tay, Mống mắt, Võng mạc và Mật khẩu, cùng dữ liệu Nhiệt độ cơ thể và Khẩu trang nếu phần cứng cung cấp.

Callback API khác RESTful API ở điểm nào?

Callback API là giao tiếp thời gian thực từ thiết bị đến máy chủ thông qua một URL bạn mở trên máy chủ của mình (không có độ trễ). RESTful API là giao tiếp từ máy chủ đến thiết bị mà bạn gọi trên endpoint của Cams để quản lý thiết bị, với độ trễ lên tới khoảng 15 giây.

Tôi có thể dùng API nếu máy chủ không có IP công khai không?

Có. Hãy dùng LoadLog API để lấy log chấm công trong một khoảng thời gian nhất định theo yêu cầu, miễn là thiết bị được kết nối internet.

Liên quan

Khám phá thêm về nền tảng