퀵스타트
개발자 포털에서 계정을 만들고 시리얼 번호로 기기를 페어링하세요. AuthToken를 받게 됩니다.
호출할 때마다 AuthToken를 함께 전달하세요. 계정과 해당 기기로 접근 범위가 제한됩니다.
먼저 GetAttendanceByDate로 데이터가 정상적으로 수신되는지 확인한 다음, 등록과 출입 통제로 넘어가세요.
https://api.camsbiometrics.com/v3/
# Fetch attendance for a date range curl https://api.camsbiometrics.com/v3/attendance/getbyscandate \ -d "AuthToken=$API_KEY" \ -d "StartDate=2026-06-01" \ -d "EndDate=2026-06-21"
$ch = curl_init("https://api.camsbiometrics.com/v3/attendance/getbyscandate"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => [ "AuthToken" => $apiKey, "StartDate" => "2026-06-01", "EndDate" => "2026-06-21", ], ]); $data = json_decode(curl_exec($ch), true);
import requests r = requests.post( "https://api.camsbiometrics.com/v3/attendance/getbyscandate", data={ "AuthToken": api_key, "StartDate": "2026-06-01", "EndDate": "2026-06-21", }, ) logs = r.json()["Attendance"]
const res = await fetch( "https://api.camsbiometrics.com/v3/attendance/getbyscandate", { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ AuthToken: apiKey, StartDate: "2026-06-01", EndDate: "2026-06-21", }), } ); const { Attendance } = await res.json();
모든 작업에 같은 패턴이 적용됩니다. 경로와 파라미터만 바꾸면 됩니다.
자주 쓰는 레시피
curl .../v3/user/add \ -d "AuthToken=$K" \ -d "DeviceSN=ZK6A2300583" \ -d "EmployeeCode=1042" \ -d "Name=Priya"
curl .../v3/access/opendoor \ -d "AuthToken=$K" \ -d "DeviceSN=ZK6A2300583" \ -d "DoorNo=1"
curl .../v3/callback/register \ -d "AuthToken=$K" \ -d "Url=https://app/hook" \ -d "Events=attendance.new"
클라이언트 측 코드에 AuthToken를 절대 포함하지 마세요. 백엔드를 통해 호출을 프록시하세요.
게이트웨이는 200를 반환할 때까지 재시도합니다. 이벤트 ID로 중복을 제거하면 재시도가 안전합니다.
기기가 오프라인이면 409가 반환되며 명령은 대기열에 등록됩니다. GetCommandStatus를 폴링하세요.
로컬 테스트
개발 PC는 방화벽 뒤에 있으므로 게이트웨이가 localhost에 직접 접근할 수 없습니다. 터널로 외부에 노출하고, Callback URL을 공개 주소로 지정한 다음 테스트 출퇴근 기록을 발생시키세요.
200를 받을 때까지 재시도합니다# 1. install & authenticate ngrok ngrok config add-authtoken $TOKEN # 2. expose your local app (e.g. port 3000) ngrok http 3000 # Forwarding https://abc123.ngrok-free.app -> localhost:3000 # 3. set that HTTPS URL as your Callback URL
# Cams ngrok helper kit (Windows) # download: developer.camsbiometrics.com/setup/ngrok-helper-kit.rar # then: edit app.properties # add your ngrok authtoken run check_ngrok.bat
기기 연결
대부분의 출퇴근 단말기(ZKTeco, eSSL 및 호환 제품)는 ICLOCK / push 프로토콜을 사용합니다. 기기에서 클라우드 서버 항목을 설정하면 PC나 로컬 소프트웨어 없이 출퇴근 데이터가 계정으로 전송됩니다.
클라우드 서버를 설정하기 전에 기기의 IP / 서브넷 / 게이트웨이 / DNS를 LAN에 맞게 설정하세요(또는 DHCP 사용).
트래픽을 측정하고 BiometricAPI.com을 개선하기 위해 쿠키를 사용합니다. 동의하기 전까지 분석은 꺼져 있습니다. 자세히 알아보기.