Introduzione
Cams Biometric Gateway — Web API 3.0
La Cams Biometric Gateway è l’API biometrica universale che collega qualsiasi dispositivo biometrico di rilevazione presenze o controllo accessi alla tua applicazione — ERP, HRMS, paghe, gestione scolastica, software su misura o workflow di IA/automazione. Supporta tutte le principali marche di dispositivi e offre un’API biometrica JSON su HTTP standardizzata, indipendentemente dall’hardware.
38 operazioni — 11 API di callback (Dispositivo → Server) e 27 API RESTful (Server → Dispositivo). Tutti i payload sono JSON grezzo su HTTP/HTTPS.
Sono supportati tutti i dispositivi biometrici. Dispositivi Cams, dispositivi verificati e marche di terze parti (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC e altre). Scegli la
modalità di connessione più adatta alla tua installazione.
Come funziona
La Biometric Gateway è composta da:
Gateway ServerPiattaforma ospitata nel cloud che include il Cams Protocol Engine (traduzione dei protocolli, normalizzazione dei dati, cache offline, autenticazione) e il livello di API standardizzata che offre un’interfaccia coerente alla tua applicazione.
Protocol EngineIl motore centrale del Gateway Server: comunica con i dispositivi biometrici, traduce i protocolli specifici di ciascun produttore e gestisce la registrazione sicura delle transazioni di dati e la gestione delle identità.
Protocol Engine LiteVersione on-premise installabile sul tuo server (Windows/Linux) per ambienti solo LAN o self-hosted. Stessa API, distribuita in locale.
Si integra con
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Applicazioni web su misura
La tua applicazione
ERP
HRMS
Paghe
ERP scolastico
Workflow IA (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
App su misura
Protocol Engine
Elaborazione sicura dell’autenticazione
Registrazione delle transazioni di dati
Traduzione dei protocolli
Cache offline & coda
Crittografia AES-256 · Validazione del token di autenticazione
Livello API standardizzato
Gestione delle identità
Integrazione IA / MCP
Dispatcher dei callback
Router dei comandi REST
Normalizzazione dei dati · Supporto multi-marca
Impronta digitale
·
Riconoscimento facciale
·
Vene del palmo
·
Badge RFID
·
PIN
·
QR / Codice a barre
·
Tracciamento GPS
Dispositivi biometrici — Tutte le marche supportate
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ Molti altri
| Tipo di API | Direzione | Latenza | Caso d’uso |
|---|
| API di callback | Dispositivo → Il tuo server | Tempo reale / latenza zero | Ricevere le timbrature e gli eventi di sincronizzazione utenti |
| API RESTful | Il tuo server → Dispositivo | ~15 secondi | Aggiungere/eliminare utenti, caricare i log, registrare dati biometrici |
Introduzione
Per iniziare
Integra in tre passaggi. Il tuo server deve avere un URL raggiungibile pubblicamente per ricevere i callback.
1
Configura l’URL di callback
Accedi al portale API Monitor. Imposta l’URL HTTPS pubblico del tuo server come URL di callback per i tuoi dispositivi. Il motore API invierà (POST) gli eventi biometrici a questo endpoint in tempo reale.
2
Ricevi le timbrature
Il tuo endpoint riceve una POST con corpo JSON grezzo — nessun parametro di query per le API di callback. Valida l’AuthToken, analizza i dati della timbratura e rispondi con {"status":"done"}.
3
Chiama le API RESTful per gestire utenti & dispositivi
Invia (POST) un comando JSON all’URL dell’endpoint RESTful fornito nel tuo account API Monitor, con il tuo stgid (Service Tag ID) come parametro di query. Il motore mette in coda il comando e il dispositivo lo conferma entro ~15 secondi.
Formato dell’endpoint
| Tipo di API | Metodo | Come inviare |
|---|
| API di callback (in ingresso) |
POST |
Il dispositivo invia (POST) al tuo URL configurato. Corpo JSON grezzo; nessun parametro. |
| API RESTful (in uscita) |
POST |
Invii (POST) all’URL dell’endpoint RESTful (disponibile nel tuo account API Monitor) con ?stgid=YOUR_SERVICE_TAG_ID e un corpo JSON grezzo. |
Rispondi sempre subito alle richieste di callback. Il tuo server deve restituire {"status":"done"} (HTTP 200) per confermare la ricezione. Non eseguire elaborazioni pesanti prima di rispondere — mettile in coda.
Documentazione
Documentazione API
Il riferimento è suddiviso per argomento. Parti dalla compatibilità dei dispositivi, poi passa alle operazioni di callback e REST.
Dispositivi supportati e modalità di connessioneQuali dispositivi supporta la Gateway, come si connette ciascuno (Native Push o Hybrid Push) e quali operazioni API sono disponibili in ciascuna modalità.
Riferimento API: architettura, campi e codici di statoGli elementi comuni a tutte le operazioni: flusso delle richieste, campi JSON comuni, tipi di template, codici di stato, porte e crittografia dei payload.
API di callback: eventi in tempo reale dal dispositivo al tuo serverTutti gli eventi che un dispositivo invia al tuo URL di callback, con il JSON che il tuo server riceve e la risposta che deve restituire.
API RESTful: comandi dal tuo server al dispositivoI comandi che il tuo server invia a un dispositivo tramite la Gateway, con il JSON di richiesta e risposta per ciascuno.
Testare l’API in localeCome ricevere i callback dei dispositivi su una macchina di sviluppo e testare i comandi REST con Postman prima del rilascio.
Esempio PHP: salvare le presenze biometriche in MySQLUn gestore di callback PHP funzionante che salva le timbrature in MySQL, in tre passaggi.
Prompt IA per generare codiceCopia un prompt nel tuo assistente IA per generare il codice di integrazione per il tuo stack.
FAQ, SDK e costiLe domande più frequenti degli integratori, oltre al funzionamento di SDK e prezzi dell’API.
