HTTP Attendance API

Punctul unic de ingestie HTTPS pentru orice client care produce prezență. HTTP Attendance API se autentifică după numărul de serie al dispozitivului și token, apoi trimite fiecare pontaj recunoscut în același pipeline de stocare și de transmitere către client ca orice motor Cams nativ.

Începeți Documentație pentru dezvoltatori

Prezentare generală

O poartă HTTPS independentă de dispozitiv pentru preluarea pontajelor de prezență, a heartbeat-urilor și a verificărilor de abonament de la orice client.

HTTP Attendance API este poarta de intrare independentă de dispozitiv, pe calea /api/attendance/v1/{op}. Autentifică fiecare cerere după antetele numărului de serie al dispozitivului (sn) și auth-token, apoi o preia. Expune punch (un eveniment de prezență recunoscut), heartbeat (prezența dispozitivului), validity (verificarea abonamentului) și config. Pontajele ajung în pipeline-ul comun, oferind aceeași stocare și aceeași transmitere ulterioară către serverul clientului ca transporturile native HTTP, TCP și MQTT — astfel încât integrările rămân coerente indiferent de modul în care ajunge prezența.

APIRESTHTTPSJSONC++

Utilizat în:Școli, colegii și campusuri

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}

Capabilități

Ce face

Preluarea unui pontaj

Trimiteți prin POST un eveniment de prezență recunoscut, cu utilizator, marcaj de timp, stare IN/OUT, tipul de intrare și, opțional, locație.

Raportarea prezenței dispozitivului

Trimiteți un heartbeat pentru a marca un dispozitiv ca online, fără niciun corp de cerere.

Verificarea valabilității

Interogați dacă abonamentul de prezență al dispozitivului este activ înainte de a trimite date.

Pipeline unificat

Fiecare pontaj ajunge în același traseu de stocare și transmitere ca ingestia nativă TCP și MQTT.

Funcționalități

Tot ce este inclus

Un singur punct de ingestie HTTPS pentru clienți edge, de aplicație, web și hibrizi, pe /api/attendance/v1/{op}
Autentificare bazată pe antete: numărul de serie al dispozitivului (sn) plus auth-token, cu control al accesului prin abonament
endpoint-ul punch preia un eveniment de prezență recunoscut (utilizator, oră, IN/OUT, tip de intrare, geolocație opțională)
endpoint-ul heartbeat marchează un dispozitiv ca online pentru urmărirea prezenței
endpoint-ul validity returnează starea live a abonamentului înainte ca un client să trimită date
Pipeline comun: aceeași stocare și aceeași transmitere către serverul clientului ca motoarele native
Contract uniform de erori JSON pentru serie lipsă, dispozitiv necunoscut, token invalid sau abonament inactiv
Plasat în spatele nginx, cu limite de dimensiune a corpului cererii și limitare a ratei

Construiți cu HTTP Attendance API

Luați o cheie, citiți documentația și lansați. Echipa noastră vă ajută cu prima integrare.

Discutați cu un inginer WhatsApp

Întrebări frecvente

Ce face HTTP Attendance API?

Este poarta de intrare independentă de dispozitiv care acceptă pontaje de prezență recunoscute, heartbeat-uri și verificări de abonament, le autentifică după numărul de serie al dispozitivului și token și le trimite în pipeline-ul comun de prezență Cams.

Cum sunt autentificate cererile?

Fiecare cerere conține un antet cu numărul de serie al dispozitivului (sn) și un antet auth-token; ambele trebuie să fie valide. Endpoint-urile biometrice necesită în plus un abonament de prezență activ.

Este prezența primită prin HTTP tratată la fel ca cea de la dispozitive?

Da. Pontajele ajung în același pipeline folosit de motoarele native HTTP, TCP și MQTT, astfel încât stocarea și transmiterea ulterioară sunt identice, indiferent de transport.