Acasă / Produse / API-uri / Biometric Gateway Web API

API

Biometric Gateway Web API

Biometric Gateway Web API (cunoscut și ca Universal Biometric Web API 3.0) transformă orice dispozitiv acceptat cu amprentă, față, palmă, vene, iris, retină, card sau parolă într-un endpoint conectat la cloud, cu care aplicația dumneavoastră poate comunica de oriunde din lume. Primiți pontaje în timp real în clipa în care se produc și gestionați de la distanță utilizatorii de pe dispozitiv, totul printr-un contract simplu REST plus Callback.

Începeți Documentație pentru dezvoltatori

Prezentare generală

Conectați orice dispozitiv biometric de prezență sau de control al accesului cu acces la internet direct la aplicația dumneavoastră web, prin HTTP — fără software local, PC sau bază de date.

Web API-ul principal Cams permite comunicarea de la mașină la server între dispozitivele biometrice instalate la distanță și aplicația dumneavoastră de pe server. Un dispozitiv se conectează la internet, prezența este transmisă în timp real către URL-ul dumneavoastră de callback (webhook), iar serverul dumneavoastră execută operațiuni pe dispozitiv, precum adăugarea sau ștergerea utilizatorilor, trimiterea de șabloane și de fotografii și încărcarea jurnalelor de pontaj, prin apeluri RESTful. Nu este nevoie să instalați software desktop, să rulați o bază de date locală sau să păstrați un PC în rețeaua LAN. API-ul este independent de baza de date și funcționează cu orice limbaj de backend.

APIRESTCallback/Webhook (HTTP POST)MQTT (calea conexiunii persistente EMQX)PHPPythonJavaNode.js

Utilizat în:Managementul vizitatorilor Evenimente, festivaluri și stadioane

Callback (webhook) — pontaj în timp real

# Your Callback URL receives every punch in real time
POST https://yourapp.com/cams/callback
{
  "DeviceSN": "SN7A2300583",
  "EmployeeCode": "1042",
  "AttendanceLog": "2026-06-21 09:02:14",
  "Type": "face",
  "Direction": "CheckIn"
}

Capabilități

Ce face

Prezență în timp real

Pontajele sunt transmise către URL-ul dumneavoastră de callback în clipa în care sunt înregistrate pe dispozitiv.

Gestionarea de la distanță a utilizatorilor

Adăugați, ștergeți, blocați și mutați utilizatori și trimiteți șabloane sau fotografii către dispozitive de pe serverul dumneavoastră, prin apeluri RESTful.

Captură multimodală

Un singur contract gestionează intrări de tip amprentă, față, palmă, vene, iris, retină, card și parolă.

Reziliență offline

Pontajele offline sunt stocate temporar pe dispozitiv și retransmise în ordine după restabilirea conectivității.

Transport criptat

Criptarea datelor brute AES-256 poate fi activată per dispozitiv pentru un schimb sigur de date.

Funcționalități

Tot ce este inclus

Callback (webhook) API livrează pontajele de prezență în timp real de la dispozitiv la serverul dumneavoastră, fără latență de polling
API RESTful pentru operațiuni de la server la dispozitiv: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog și altele (38 de operațiuni)
Captează mai multe tipuri de intrare per pontaj: Fingerprint, Face, Card, Palm, Finger Vein, Iris, Retina, Password, plus indicatori Body Temperature și Face Mask acolo unde hardware-ul le acceptă
Tipurile de pontaj includ CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
Gestionează pontajele offline: datele din coadă sunt transmise în ordine când dispozitivul se reconectează
Criptare AES-256 opțională a tuturor datelor brute schimbate, cu cheie de securitate setată în API Monitor
LoadLog API permite aplicațiilor non-server și celor doar-LAN să preia la cerere până la 30 de zile de istoric al prezenței
Coduri de stare documentate pentru gestionarea robustă a erorilor, cu urmărire prin AuthToken per dispozitiv și OperationID pentru suport și reconciliere

Construiți cu Biometric Gateway Web 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

Trebuie să instalez vreun software în rețeaua mea locală pentru a folosi Web API?

Nu. Comunicarea are loc prin HTTP între dispozitiv și serverul dumneavoastră. Atât timp cât dispozitivul este conectat la internet, puteți primi prezența și gestiona utilizatorii fără software local, bază de date sau PC.

Ce intrări biometrice acceptă Web API?

Amprentă, față, card, palmă, vene ale degetului, iris, retină și parolă, plus date despre temperatura corporală și masca facială acolo unde hardware-ul le furnizează.

Care este diferența dintre Callback API și API-ul RESTful?

Callback API este comunicarea în timp real de la dispozitiv la server, printr-un URL pe care îl expuneți pe serverul dumneavoastră (fără latență). API-ul RESTful este comunicarea de la server la dispozitiv, pe care o apelați pe endpoint-ul Cams pentru a gestiona dispozitivul, cu o latență de până la aproximativ 15 secunde.

Pot folosi API-ul dacă serverul meu nu are IP public?

Da. Folosiți LoadLog API pentru a prelua la cerere jurnalele de prezență pentru un interval de timp dat, atât timp cât dispozitivul este conectat la internet.