홈 / 제품 / API / Biometric Gateway Web API

API

Biometric Gateway Web API

Biometric Gateway Web API(Universal Biometric Web API 3.0이라고도 함)는 지원되는 지문, 얼굴, 손바닥, 정맥, 홍채, 망막, 카드 또는 비밀번호 기기를 전 세계 어디서나 애플리케이션이 통신할 수 있는 클라우드 연결 엔드포인트로 바꿔 줍니다. 출퇴근 기록을 발생 즉시 실시간으로 수신하고 기기의 사용자를 원격으로 관리할 수 있으며, 모두 간단한 REST와 Callback 규격으로 제공됩니다.

시작하기 개발자 문서

개요

인터넷에 연결된 모든 생체인식 출퇴근 또는 출입 통제 기기를 HTTP로 웹 애플리케이션에 직접 연결하세요. 로컬 소프트웨어, PC, 데이터베이스가 필요 없습니다.

Cams의 대표 Web API는 원격에 설치된 생체인식 기기와 서버 애플리케이션 간의 머신 대 서버 통신을 지원합니다. 기기가 인터넷에 연결되면 출퇴근 데이터가 Callback(webhook) URL로 실시간 푸시되고, 서버는 RESTful 호출로 사용자 추가 또는 삭제, 템플릿 푸시, 사진 푸시, 출퇴근 로그 로드 같은 기기 작업을 수행합니다. 데스크톱 소프트웨어를 설치하거나, 로컬 데이터베이스를 운영하거나, LAN에 PC를 켜 둘 필요가 없습니다. 이 API는 데이터베이스에 종속되지 않으며 어떤 백엔드 언어에서도 사용할 수 있습니다.

APIRESTCallback/Webhook (HTTP POST)MQTT (EMQX 상시 연결 경로)PHPPythonJavaNode.js

활용 분야:방문자 관리 이벤트, 페스티벌 및 경기장

Callback (webhook) — 실시간 출퇴근 기록

# 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"
}

기능

할 수 있는 일

실시간 출퇴근

출퇴근 기록은 기기에 기록되는 즉시 Callback URL로 푸시됩니다.

원격 사용자 관리

RESTful 호출로 서버에서 사용자를 추가, 삭제, 차단, 이동하고 템플릿이나 사진을 기기로 푸시합니다.

멀티모달 캡처

하나의 규격으로 지문, 얼굴, 손바닥, 정맥, 홍채, 망막, 카드, 비밀번호 입력을 모두 처리합니다.

오프라인 복원력

오프라인 상태의 출퇴근 기록은 기기에 버퍼링되었다가 연결이 복구되면 순서대로 재전송됩니다.

암호화된 전송

안전한 데이터 교환을 위해 기기별로 AES-256 원시 데이터 암호화를 사용할 수 있습니다.

주요 기능

모두 포함

Callback(webhook) API가 폴링 지연 없이 기기의 실시간 출퇴근 기록을 서버로 전달
서버에서 기기로의 작업을 위한 RESTful API: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog 등(38개 작업)
출퇴근 기록마다 여러 입력 유형 캡처: Fingerprint, Face, Card, Palm, Finger Vein, Iris, Retina, Password, 그리고 하드웨어가 지원하는 경우 Body Temperature 및 Face Mask 플래그
출퇴근 유형: CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
오프라인 출퇴근 기록 처리: 기기가 다시 연결되면 대기열 데이터를 순서대로 전송
API Monitor에서 설정한 보안 키를 기반으로, 교환되는 모든 원시 데이터의 AES-256 암호화(선택 사항)
LoadLog API로 서버가 없거나 LAN 전용인 애플리케이션도 필요할 때 최대 30일 치 출퇴근 이력을 조회 가능
견고한 오류 처리를 위한 문서화된 상태 코드, 지원 및 대조를 위한 기기별 AuthToken 및 OperationID 추적