Autentique, consulte a frequência, cadastre uma impressão digital e abra uma porta — com exemplos para copiar e colar na linguagem que você já usa.
Início rápido
Crie uma conta no portal do desenvolvedor e pareie seu dispositivo pelo número de série. Você receberá uma AuthToken.
Envie AuthToken em cada chamada. Ele restringe o acesso à sua conta e ao dispositivo específico.
Comece com GetAttendanceByDate para confirmar que os dados estão fluindo e depois passe para cadastro e controle de acesso.
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();
O mesmo padrão vale para todas as operações — basta mudar o caminho e os parâmetros.
Receitas comuns
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"
Nunca incorpore uma AuthToken em código do lado do cliente. Faça as chamadas passarem pelo seu backend.
O gateway tenta novamente até você retornar 200. Elimine duplicatas pelo id do evento para que as novas tentativas sejam seguras.
Se um dispositivo estiver offline, você receberá 409; o comando fica na fila. Consulte GetCommandStatus.
Testes locais
Sua máquina de desenvolvimento fica atrás de um firewall, então o gateway não consegue acessar localhost diretamente. Exponha-a com um túnel, aponte sua Callback URL para o endereço público e dispare uma batida de teste.
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
Conectar um dispositivo
A maioria dos terminais de frequência (ZKTeco, eSSL e compatíveis) usa o protocolo ICLOCK / push. Configure os campos de servidor na nuvem no dispositivo e ele transmite a frequência para a sua conta — sem PC nem software local.
Ajuste o IP / sub-rede / gateway / DNS do dispositivo à sua LAN (ou use DHCP) antes de configurar o servidor na nuvem.
Pareie-o no portal do desenvolvedor e faça uma chamada real em minutos.
Usamos cookies para medir o tráfego e melhorar o BiometricAPI.com. As análises ficam desativadas até você aceitar. Saiba mais.