Uwierzytelnij, pobierz obecność, zarejestruj odcisk palca i otwórz drzwi — z przykładami do skopiowania w języku, którego już używasz.
Szybki start
Załóż konto w portalu deweloperskim i sparuj urządzenie przez numer seryjny. Otrzymasz AuthToken.
Przekazuj AuthToken z każdym wywołaniem. Ogranicza on dostęp do Twojego konta i konkretnego urządzenia.
Zacznij od GetAttendanceByDate, aby potwierdzić przepływ danych, a potem przejdź do rejestracji i kontroli dostępu.
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();
Ten sam wzorzec dotyczy każdej operacji — zmień ścieżkę i parametry.
Typowe przepisy
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"
Nigdy nie osadzaj AuthToken w kodzie po stronie klienta. Kieruj wywołania przez swój backend.
Brama ponawia próby, dopóki nie zwrócisz 200. Deduplikuj po identyfikatorze zdarzenia, aby ponowienia były bezpieczne.
Jeśli urządzenie jest offline, otrzymasz 409; polecenie trafia do kolejki. Odpytaj GetCommandStatus.
Testowanie lokalne
Twój komputer deweloperski jest za zaporą, więc brama nie może bezpośrednio dotrzeć do localhost. Udostępnij go przez tunel, wskaż publiczny adres jako Callback URL i wywołaj testowe odbicie.
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
Podłącz urządzenie
Większość terminali obecności (ZKTeco, eSSL i zgodne) używa protokołu ICLOCK / push. Ustaw pola serwera w chmurze na urządzeniu, a będzie ono przesyłać obecność na Twoje konto — bez komputera i lokalnego oprogramowania.
Przed ustawieniem serwera w chmurze dopasuj IP / podsieć / bramę / DNS urządzenia do swojej sieci LAN (lub użyj DHCP).
Sparuj je w portalu deweloperskim i wykonaj wywołanie na żywo w kilka minut.
Używamy plików cookie do pomiaru ruchu i ulepszania BiometricAPI.com. Analityka pozostaje wyłączona, dopóki jej nie zaakceptujesz. Dowiedz się więcej.