Cams Biometric Gateway — Web API 3.0
The Cams Biometric Gateway is the universal Biometric API that connects any biometric attendance or access control machine with your application — ERP, HRMS, payroll, school management, custom software, or AI/automation workflow. It supports all major device brands and provides a standardised JSON-over-HTTP Biometric API regardless of the hardware.
작동 방식
Biometric Gateway는 다음으로 구성됩니다.
연동 대상
| API 유형 | 방향 | 지연 시간 | 사용 사례 |
|---|---|---|---|
| 콜백 API | 장비 → 사용자 서버 | 실시간 / 지연 없음 | 근태 기록 및 사용자 동기화 이벤트 수신 |
| RESTful API | 사용자 서버 → 장비 | 약 15초 | 사용자 추가/삭제, 로그 불러오기, 생체 정보 등록 |
시작하기
세 단계로 연동할 수 있습니다. 콜백을 수신하려면 서버에 외부에서 접근 가능한 URL이 필요합니다.
콜백 URL 설정
API Monitor 포털에 로그인하여 서버의 공개 HTTPS URL을 장비의 콜백 URL로 설정합니다. API 엔진이 생체인식 이벤트를 이 엔드포인트로 실시간 POST합니다.
근태 기록 수신
엔드포인트는 raw JSON 본문이 담긴 POST를 수신합니다. 콜백 API에는 쿼리 매개변수가 필요하지 않습니다. AuthToken을 검증하고 기록 데이터를 파싱한 뒤 {"status":"done"}으로 응답하세요.
RESTful API로 사용자 및 장비 관리
API Monitor 계정에 제공된 RESTful 엔드포인트 URL로, stgid(Service Tag ID)를 쿼리 매개변수로 붙여 JSON 명령을 POST합니다. 엔진이 명령을 큐에 넣고, 장비는 약 15초 이내에 응답합니다.
엔드포인트 형식
| API 유형 | 메서드 | 전송 방법 |
|---|---|---|
| 콜백 API(인바운드) | POST | 장비가 사용자가 설정한 URL로 POST합니다. raw JSON 본문이며 매개변수는 없습니다. |
| RESTful API(아웃바운드) | POST | RESTful 엔드포인트 URL(API Monitor 계정에서 확인)로 ?stgid=YOUR_SERVICE_TAG_ID와 raw JSON 본문을 붙여 POST합니다. |
{"status":"done"}(HTTP 200)을 반환해야 합니다. 응답하기 전에 무거운 처리를 하지 말고 큐에 넣으세요.
API 문서
레퍼런스는 주제별로 나뉘어 있습니다. 먼저 장비 호환성을 확인한 다음 콜백 및 REST 오퍼레이션을 살펴보세요.
문의하기
API 지원, 장비 호환성 또는 영업 문의:
영업 & 지원
Cams Biometrics(Dheeram Innovations Pvt Ltd) — No: 2/98D, 2nd Floor, Cams Biometrics Building, Opposite to Satyabama University, Semmancheri, OMR, Chennai – 600119, India.