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.
Cách hoạt động
Biometric Gateway bao gồm:
Tích hợp với
| 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 |
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.
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.
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"}.
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ô. |
{"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 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.
Liên hệ
Để được hỗ trợ API, tư vấn về thiết bị tương thích hoặc liên hệ kinh doanh:
Kinh doanh & Hỗ trợ
Tài nguyên cho nhà phát triển
Cams Biometrics (Dheeram Innovations Pvt Ltd) — No: 2/98D, 2nd Floor, Cams Biometrics Building, Opposite to Satyabama University, Semmancheri, OMR, Chennai – 600119, India.