Home / Prodotti / API / REST Management API
API

REST Management API

Controllo programmatico della tua flotta di dispositivi. La Cams REST Management API ti permette di aggiungere, registrare ed eliminare utenti, inviare template di impronte e volto e foto, controllare le fasce orarie di accesso, abilitare o disabilitare utenti e recuperare o reinviare i log delle presenze — tutto con un contratto REST stabile e versionato.

Panoramica

Un'API REST versionata (V1/V2/V3) per gestire l'intero ciclo di vita di dispositivi e utenti — provisioning, comandi, template, foto, fasce orarie di accesso e log delle presenze.

La REST Management API è il livello di comandi per la gestione dei dispositivi della piattaforma Cams e serve in parallelo tre versioni del contratto (V1, V2, V3), ciascuna con la propria convalida ed elaborazione. Copre l'intero ciclo di vita degli utenti sui dispositivi di presenza Cams — aggiunta utente, aggiunta template, aggiunta foto, registrazione, eliminazione, abilitazione o disabilitazione, aggiornamento delle fasce orarie, caricamento e reinvio dei log delle timbrature, reinvio degli utenti, riavvio e inizializzazione — e instrada i payload dei template versionati al tenant corretto tramite la mappatura device-pair e master-id. È la controparte operativa delle API di acquisizione in tempo reale.

APIRESTHTTPSJSONC++

Pensato per

Sviluppatori e integratori HR/paghe che gestiscono in modo programmatico utenti dei dispositivi, template biometrici e log delle presenze.

API REST biometricaAPI di gestione dei dispositiviAPI per dispositivi di presenzaAPI per template di impronteAPI di registrazione utentiAPI per log delle timbratureAPI per fasce orarie di accessoAPI REST versionata

Funzionalità

Che cosa fa

Gestione degli utenti

Aggiungi, registra, elimina e abilita o disabilita gli utenti sui dispositivi in modo programmatico.

Invio di template e foto

Invia ai dispositivi template di impronte o volto e foto degli utenti per il matching on-device.

Recupero delle presenze

Carica i log delle timbrature e reinvia i record di presenza su richiesta.

Contratti versionati

Servi V1, V2 e V3 in parallelo, così i client possono migrare con i propri tempi.

Gestione dei dispositivi

Riavvia o inizializza un dispositivo e invia o reinvia l'elenco utenti da remoto.

Caratteristiche

Tutto incluso

  • Tre contratti API versionati (V1, V2, V3) serviti in parallelo, con convalida per versione
  • Ciclo di vita degli utenti: aggiunta, registrazione, eliminazione, abilitazione o disabilitazione degli utenti in modo programmatico
  • Gestione dei dati biometrici: invio di template di impronte e volto e di foto per ciascun utente
  • Accesso alle presenze: caricamento dei log delle timbrature e reinvio dei record di presenza su richiesta
  • Controllo accessi: aggiornamento delle fasce orarie di accesso per utente
  • Controllo dei dispositivi: riavvio e inizializzazione da remoto
  • Parsing dei dati dei template versionati (R20, R30) con instradamento al tenant tramite device-pair e master-id
  • Envelope di comando GET/PUT uniforme su un unico modello di operazioni e parametri

Sviluppa con REST Management API

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

FAQ

Domande frequenti

Che cosa può fare la REST Management API?

Gestisce il ciclo di vita di utenti e dati biometrici sui dispositivi Cams: aggiunta, registrazione, eliminazione, abilitazione o disabilitazione degli utenti; invio di template e foto; impostazione delle fasce orarie di accesso; caricamento e reinvio dei log delle timbrature; invio degli elenchi utenti; e riavvio o inizializzazione dei dispositivi.

Quali versioni dell'API sono supportate?

V1, V2 e V3 sono servite in parallelo, ciascuna con il proprio livello di convalida ed elaborazione, così i client possono migrare con i propri tempi.

Supporta i template di impronte e volto?

Sì. Operazioni dedicate inviano template di impronte o volto e foto, così le credenziali biometriche possono essere inviate ai dispositivi in modo programmatico, inclusi i payload di template versionati R20 e R30.

Correlati

Esplora altre parti della piattaforma