Giới thiệu
Cams Biometric Gateway — Web API 3.0
Cams Biometric Gateway là Biometric API phổ quát, kết nối bất kỳ máy chấm công hoặc thiết bị kiểm soát ra vào sinh trắc học nào với ứng dụng của bạn — ERP, HRMS, tính lương, quản lý trường học, phần mềm tùy chỉnh hoặc quy trình AI/tự động hóa. Gateway hỗ trợ tất cả các thương hiệu thiết bị lớn và cung cấp Biometric API chuẩn hóa dạng JSON qua HTTP, bất kể phần cứng.
38 thao tác — 11 Callback API (Thiết bị → Máy chủ) và 27 RESTful API (Máy chủ → Thiết bị). Tất cả payload là JSON thô qua HTTP/HTTPS.
Hỗ trợ mọi thiết bị sinh trắc học. Thiết bị Cams, thiết bị đã được xác minh và các thương hiệu bên thứ ba (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC và nhiều hãng khác). Hãy chọn
chế độ kết nối phù hợp với hệ thống của bạn.
Cách hoạt động
Biometric Gateway bao gồm:
Máy chủ GatewayNền tảng lưu trữ trên đám mây, bao gồm Cams Protocol Engine (chuyển đổi giao thức, chuẩn hóa dữ liệu, bộ nhớ đệm ngoại tuyến, xác thực) và lớp API chuẩn hóa mang lại giao diện nhất quán cho ứng dụng của bạn.
Protocol EngineEngine lõi trong máy chủ Gateway, giao tiếp với các thiết bị sinh trắc học, chuyển đổi các giao thức riêng của từng hãng, đồng thời xử lý việc ghi nhật ký giao dịch dữ liệu an toàn và quản lý danh tính.
Protocol Engine LitePhiên bản tại chỗ (on-premise) có thể cài trên máy chủ của riêng bạn (Windows/Linux) cho môi trường chỉ có mạng LAN hoặc tự lưu trữ. Cùng một API, triển khai cục bộ.
Tích hợp với
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Ứng dụng web tùy chỉnh
Ứng dụng của bạn
ERP
HRMS
Tính lương
ERP trường học
Quy trình AI (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
Ứng dụng tùy chỉnh
Protocol Engine
Xử lý xác thực an toàn
Ghi nhật ký giao dịch dữ liệu
Chuyển đổi giao thức
Bộ nhớ đệm & hàng đợi ngoại tuyến
Mã hóa AES-256 · Xác thực Auth Token
Lớp API chuẩn hóa
Quản lý danh tính
Tích hợp AI / MCP
Bộ điều phối Callback
Bộ định tuyến lệnh REST
Chuẩn hóa dữ liệu · Hỗ trợ giao thức đa thương hiệu
Vân tay
·
Nhận diện khuôn mặt
·
Tĩnh mạch lòng bàn tay
·
Thẻ RFID
·
PIN
·
QR / Mã vạch
·
Theo dõi GPS
Thiết bị sinh trắc học — Hỗ trợ mọi thương hiệu
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ Nhiều hãng khác
| Loại API | Hướng | Độ trễ | Trường hợp sử dụng |
|---|
| Callback API | Thiết bị → Máy chủ của bạn | Thời gian thực / độ trễ bằng 0 | Nhận các lượt chấm công, sự kiện đồng bộ người dùng |
| RESTful API | Máy chủ của bạn → Thiết bị | ~15 giây | Thêm/xóa người dùng, tải log, đăng ký sinh trắc học |
Giới thiệu
Bắt đầu
Tích hợp trong ba bước. Máy chủ của bạn cần có URL truy cập công khai để nhận callback.
1
Cấu hình Callback URL
Đăng nhập cổng API Monitor. Đặt URL HTTPS công khai của máy chủ bạn làm Callback URL cho (các) thiết bị. API engine sẽ POST các sự kiện sinh trắc học đến endpoint này theo thời gian thực.
2
Nhận các lượt chấm công
Endpoint của bạn nhận một yêu cầu POST với body JSON thô — Callback API không cần tham số truy vấn. Hãy xác thực AuthToken, phân tích dữ liệu chấm công và phản hồi bằng {"status":"done"}.
3
Gọi RESTful API để quản lý người dùng & thiết bị
POST một lệnh JSON đến URL endpoint RESTful có trong tài khoản API Monitor của bạn, kèm stgid (Service Tag ID) làm tham số truy vấn. Engine đưa lệnh vào hàng đợi và thiết bị xác nhận trong khoảng ~15 giây.
Định dạng endpoint
| Loại API | Phương thức | Cách gửi |
|---|
| Callback API (chiều vào) |
POST |
Thiết bị gửi POST đến URL do bạn cấu hình. Body JSON thô; không có tham số. |
| RESTful API (chiều ra) |
POST |
Bạn POST đến URL endpoint RESTful (có trong tài khoản API Monitor của bạn) kèm ?stgid=YOUR_SERVICE_TAG_ID và body JSON thô. |
Luôn phản hồi yêu cầu Callback ngay lập tức. Máy chủ của bạn phải trả về {"status":"done"} (HTTP 200) để xác nhận đã nhận. Không xử lý nặng trước khi phản hồi — hãy đưa vào hàng đợi.
Tài liệu
Tài liệu API
Tài liệu tham chiếu được chia theo chủ đề. Bắt đầu với phần thiết bị tương thích, sau đó đến các thao tác callback và REST.
Thiết bị được hỗ trợ và chế độ kết nốiGateway hỗ trợ những thiết bị nào, mỗi thiết bị kết nối ra sao (Native Push hoặc Hybrid Push) và thao tác API nào khả dụng trong từng chế độ.
Tham chiếu API: kiến trúc, trường dữ liệu và mã trạng tháiCác thành phần dùng chung cho mọi thao tác: luồng yêu cầu, các trường JSON chung, loại template, mã trạng thái, cổng và mã hóa payload.
Callback API: sự kiện thời gian thực từ thiết bị đến máy chủ của bạnMọi sự kiện thiết bị gửi đến callback URL của bạn, kèm JSON máy chủ nhận được và phản hồi cần trả về.
RESTful API: lệnh từ máy chủ của bạn đến thiết bịCác lệnh máy chủ của bạn gửi đến thiết bị thông qua Gateway, kèm JSON yêu cầu và phản hồi cho từng lệnh.
Kiểm thử API cục bộCách nhận callback của thiết bị trên máy phát triển và kiểm thử lệnh REST bằng Postman trước khi triển khai.
Ví dụ PHP: lưu dữ liệu chấm công sinh trắc học vào MySQLTrình xử lý callback PHP hoạt động được, lưu các lượt chấm công vào MySQL, chỉ với ba bước.
Prompt tạo mã bằng AISao chép một prompt vào trợ lý AI của bạn để tạo mã tích hợp cho công nghệ của riêng bạn.
FAQ, SDK và chi phíCác câu hỏi thường gặp từ đơn vị tích hợp, cùng cách SDK và giá API hoạt động.
