Home / Prodotti / API / Biometric Gateway Web API

API

Biometric Gateway Web API

La Biometric Gateway Web API (nota anche come Universal Biometric Web API 3.0) trasforma qualsiasi dispositivo supportato di impronte, volto, palmo, vene, iride, retina, tessera o password in un endpoint connesso al cloud con cui la tua applicazione può dialogare da qualsiasi parte del mondo. Ricevi le timbrature in tempo reale nell'istante in cui avvengono e gestisci gli utenti sul dispositivo da remoto, tutto con un semplice contratto REST più Callback.

Inizia Documentazione per sviluppatori

Panoramica

Collega qualsiasi dispositivo biometrico di presenze o controllo accessi connesso a internet direttamente alla tua applicazione web via HTTP — senza software locale, PC o database.

La Web API di punta di Cams consente la comunicazione da macchina a server tra dispositivi biometrici installati da remoto e la tua applicazione server. Un dispositivo si collega a internet, le presenze vengono inviate in tempo reale al tuo Callback URL (webhook) e il tuo server comanda operazioni sul dispositivo come aggiungere o eliminare utenti, inviare template, inviare foto e caricare i log delle timbrature tramite chiamate RESTful. Non serve installare software desktop, gestire un database locale né mantenere un PC in LAN. L'API è indipendente dal database e funziona con qualsiasi linguaggio di backend.

APIRESTCallback/Webhook (HTTP POST)MQTT (percorso a connessione persistente EMQX)PHPPythonJavaNode.js

Usato in:Gestione visitatori Eventi, festival e stadi

Callback (webhook) — timbratura in tempo reale

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

Funzionalità

Che cosa fa

Presenze in tempo reale

Le timbrature vengono inviate al tuo Callback URL nel momento in cui sono registrate sul dispositivo.

Gestione utenti da remoto

Aggiungi, elimina, blocca e sposta utenti e invia template o foto ai dispositivi dal tuo server tramite chiamate RESTful.

Acquisizione multimodale

Un unico contratto gestisce input di impronta, volto, palmo, vene, iride, retina, tessera e password.

Resilienza offline

Le timbrature offline vengono memorizzate nel dispositivo e riprodotte in ordine al ripristino della connettività.

Trasporto cifrato

La cifratura AES-256 dei dati grezzi può essere abilitata per dispositivo per uno scambio di dati sicuro.

Caratteristiche

Tutto incluso

La Callback API (webhook) consegna le timbrature in tempo reale dal dispositivo al tuo server senza latenza di polling
API RESTful per le operazioni da server a dispositivo: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog e altre (38 operazioni)
Acquisisce più tipi di input per timbratura: Fingerprint, Face, Card, Palm, Finger Vein, Iris, Retina, Password, più i flag Body Temperature e Face Mask dove l'hardware li supporta
I tipi di timbratura includono CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
Gestisce le timbrature offline: i dati in coda vengono trasmessi in sequenza quando il dispositivo si riconnette
Cifratura AES-256 opzionale di tutti i dati grezzi scambiati, con chiave di sicurezza impostata in API Monitor
L'API LoadLog consente alle applicazioni non server e solo LAN di recuperare su richiesta fino a 30 giorni di storico delle presenze
Codici di stato documentati per una gestione robusta degli errori, con tracciamento per dispositivo tramite AuthToken e OperationID per assistenza e riconciliazione

Sviluppa con Biometric Gateway Web API

Ottieni una chiave, leggi la documentazione e rilascia. Il nostro team ti assiste con la tua prima integrazione.

Parla con un tecnico WhatsApp

FAQ

Domande frequenti

Devo installare software sulla mia rete locale per usare la Web API?

No. La comunicazione avviene via HTTP tra il dispositivo e il tuo server. Finché il dispositivo è connesso a internet, puoi ricevere le presenze e gestire gli utenti senza alcun software locale, database o PC.

Quali input biometrici supporta la Web API?

Fingerprint, Face, Card, Palm, Finger Vein, Iris, Retina e Password, più i dati di Body Temperature e Face Mask dove l'hardware li fornisce.

Qual è la differenza tra la Callback API e l'API RESTful?

La Callback API è la comunicazione in tempo reale da dispositivo a server tramite un URL che esponi sul tuo server (senza latenza). L'API RESTful è la comunicazione da server a dispositivo che chiami sull'endpoint di Cams per gestire il dispositivo, con una latenza fino a circa 15 secondi.

Posso usare l'API se il mio server non ha un IP pubblico?

Sì. Usa l'API LoadLog per recuperare su richiesta i log delle presenze di un dato intervallo, purché il dispositivo sia connesso a internet.