HTTP Attendance API

L'unico punto di ingresso HTTPS per qualsiasi client che produce presenze. L'HTTP Attendance API si autentica tramite numero di serie del dispositivo e token, poi convoglia ogni timbratura riconosciuta nella stessa pipeline di archiviazione e di push verso il cliente di ogni motore Cams nativo.

Inizia Documentazione per sviluppatori

Panoramica

Un punto di ingresso HTTPS indipendente dal dispositivo per acquisire timbrature, heartbeat e verifiche di abbonamento da qualsiasi client.

L'HTTP Attendance API è il punto di ingresso indipendente dal dispositivo sul percorso /api/attendance/v1/{op}. Autentica ogni richiesta tramite gli header del numero di serie del dispositivo (sn) e dell'auth-token, poi acquisisce i dati. Espone punch (un evento di presenza riconosciuto), heartbeat (presenza del dispositivo), validity (verifica dell'abbonamento) e config. Le timbrature confluiscono nella pipeline condivisa, con archiviazione e push a valle verso il server del cliente identici ai trasporti nativi HTTP, TCP e MQTT — così le integrazioni restano coerenti indipendentemente da come arrivano le presenze.

APIRESTHTTPSJSONC++

Usato in:Scuole, università e campus

POST /api/attendance/v1/punch

curl https://api.camsbiometrics.com/api/attendance/v1/punch \
  -H "sn: SN7A2300583" -H "auth-token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id":"1001", "att_time":"2026-06-21 09:30:00",
        "att_state":1, "input_type":50 }'
# -> 200 {"ok":true}

Funzionalità

Che cosa fa

Acquisire una timbratura

Invia con POST un evento di presenza riconosciuto con utente, timestamp, stato IN/OUT, tipo di input e posizione opzionale.

Segnalare la presenza

Invia un heartbeat per segnare un dispositivo come online, senza alcun body.

Verificare la validità

Verifica se l'abbonamento alle presenze del dispositivo è attivo prima di inviare i dati.

Pipeline unificata

Ogni timbratura finisce nello stesso percorso di archiviazione e push dell'acquisizione nativa TCP e MQTT.

Caratteristiche

Tutto incluso

Un unico punto di ingresso HTTPS per client edge, app, web e ibridi su /api/attendance/v1/{op}
Autenticazione tramite header: numero di serie del dispositivo (sn) più auth-token, con controllo dell'abbonamento
L'endpoint punch acquisisce un evento di presenza riconosciuto (utente, ora, IN/OUT, tipo di input, geolocalizzazione opzionale)
L'endpoint heartbeat segna un dispositivo come online per il tracciamento della presenza
L'endpoint validity restituisce lo stato live dell'abbonamento prima che un client invii dati
Pipeline condivisa: archiviazione e push verso il server del cliente identici a quelli dei motori nativi
Contratto di errore JSON coerente per numero di serie mancante, dispositivo sconosciuto, token non valido o abbonamento non attivo
Dietro nginx, con limiti alla dimensione del body e rate limiting

Sviluppa con HTTP Attendance 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

Che cosa fa l'HTTP Attendance API?

È il punto di ingresso indipendente dal dispositivo che accetta timbrature di presenza riconosciute, heartbeat e verifiche dell'abbonamento, le autentica tramite numero di serie del dispositivo e token e le immette nella pipeline di presenze Cams condivisa.

Come vengono autenticate le richieste?

Ogni richiesta include un header con il numero di serie del dispositivo (sn) e un header auth-token; entrambi devono essere validi. Gli endpoint biometrici richiedono inoltre un abbonamento alle presenze attivo.

Le presenze via HTTP sono trattate come quelle dei dispositivi?

Sì. Le timbrature confluiscono nella stessa pipeline usata dai motori nativi HTTP, TCP e MQTT, quindi archiviazione e push a valle sono identici indipendentemente dal trasporto.