Un singur contract pentru fiecare dispozitiv. 38 de operațiuni în cinci grupuri de funcționalități, disponibile ca apeluri REST sincrone și ca webhook-uri Callback în timp real.
Toate apelurile REST se fac către o singură gazdă versionată.
https://api.camsbiometrics.com/v3/
Fiecare cerere conține un AuthToken limitat la contul și dispozitivul dumneavoastră. Cheile se emit din portalul pentru dezvoltatori.
Cereri codificate ca formular sau JSON. Răspunsurile sunt JSON, cu câmpuri și coduri de eroare previzibile.
Două moduri de integrare
Apelați gateway-ul și primiți imediat un răspuns. Ideal pentru preluarea prezenței, listarea utilizatorilor, înrolarea cuiva sau deschiderea unei uși la cerere.
Înregistrați un URL, iar gateway-ul vă trimite evenimentele în clipa în care un dispozitiv le raportează — fără polling, cu reîncercări automate în caz de eșec.
Operațiuni
Grupate după funcție. Denumirile corespund 1:1 endpoint-urilor gateway-ului.
Toate pontajele dintr-un interval de date, la nivelul întregului cont.
Jurnale pentru un singur cod de angajat într-o perioadă.
Pontajele captate de un dispozitiv cu un anumit număr de serie.
Sinteză pe zi și pe angajat (intrare/ieșire, ore).
Perechea prima intrare / ultima ieșire per angajat și zi.
Instantaneu live al pontajelor de astăzi.
Fotografii captate și atașate unui pontaj, acolo unde este acceptat.
Export în masă pentru salarizare și reconciliere.
Creați un utilizator pe unul sau mai multe dispozitive.
Modificați numele, rolul, valabilitatea sau privilegiile.
Eliminați un utilizator de pe un dispozitiv.
Căutați un utilizator după cod, cu credențiale opționale.
Enumerați toate persoanele înrolate pe un dispozitiv.
Afișați pe ce dispozitive există un utilizator.
Trimiteți un șablon de amprentă către dispozitiv.
Înregistrați un șablon facial, acolo unde este acceptat.
Atribuiți un card RFID / de proximitate unui utilizator.
Setați sau schimbați un PIN / o parolă a dispozitivului.
Clonați utilizatori și șabloane între dispozitive.
Retrimiteți datele unui utilizator în coada unui dispozitiv.
Declanșați în timp real un releu de ușă, un turnichet, o barieră tip flap, swing sau boom.
Blocați / mențineți o ușă sub controlul dumneavoastră.
Citiți starea curentă, deschis / închis.
Definiți intervale de acces bazate pe timp.
Jurnal al evenimentelor de intrare / ieșire și de ușă.
Inventarul tuturor dispozitivelor conectate.
Model, firmware, capacitate și contoare.
Stare online, ultima conectare și dimensiunea cozii.
Confirmați acum că dispozitivul este accesibil.
Aliniați ceasul dispozitivului cu cel al serverului.
Reporniți un dispozitiv de la distanță.
Eliminați comenzile blocate din coadă.
Urmăriți starea unei comenzi aflate în coadă.
Abonați un URL de webhook la evenimente live.
Declanșat la fiecare pontaj, în timp real.
Treceri online / offline și schimbări ale stării de funcționare.
Confirmare atunci când un șablon ajunge pe un dispozitiv.
Urmăriți progresul migrării în masă a dispozitivelor / datelor.
Răspunsuri previzibile
| Cod | Semnificație | Ce trebuie făcut |
|---|---|---|
200 | Succes | Procesați payload-ul JSON. |
401 | AuthToken invalid sau lipsă | Verificați cheia API și asocierea dispozitivului. |
404 | Dispozitiv sau utilizator negăsit | Verificați numărul de serie / codul angajatului. |
409 | Dispozitiv offline / în coadă | Comanda este în coadă; interogați GetCommandStatus. |
429 | Limită de cereri depășită | Așteptați și reîncercați cu jitter. |
Ghidul de pornire rapidă vă duce de la cheia API la primul jurnal de prezență în doar câteva minute.
Folosim cookie-uri pentru a măsura traficul și a îmbunătăți BiometricAPI.com. Analiza rămâne dezactivată până când acceptați. Aflați mai multe.