Introducere
Cams Biometric Gateway — Web API 3.0
Cams Biometric Gateway este Biometric API-ul universal care conectează orice dispozitiv biometric de pontaj sau de control al accesului la aplicația dumneavoastră — ERP, HRMS, salarizare, management școlar, software personalizat sau flux de lucru AI/automatizare. Acceptă toate mărcile importante de dispozitive și oferă un Biometric API standardizat de tip JSON prin HTTP, indiferent de echipament.
38 de operațiuni — 11 Callback API (dispozitiv → server) și 27 RESTful API (server → dispozitiv). Toate payload-urile sunt JSON brut prin HTTP/HTTPS.
Toate dispozitivele biometrice sunt acceptate. Dispozitive Cams, dispozitive verificate și mărci terțe (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC și altele). Alegeți
modul de conectare potrivit configurației dumneavoastră.
Cum funcționează
Biometric Gateway este alcătuit din:
Server GatewayPlatformă găzduită în cloud care include Cams Protocol Engine (translare de protocoale, normalizarea datelor, cache offline, autentificare) și stratul Standardised API, care oferă o interfață consecventă aplicației dumneavoastră.
Protocol EngineMotorul principal din Gateway Server, care comunică cu dispozitivele biometrice, traduce protocoalele specifice producătorilor și gestionează înregistrarea securizată a tranzacțiilor de date și managementul identității.
Protocol Engine LiteO versiune on-premise ce poate fi instalată pe propriul server (Windows/Linux), pentru medii exclusiv LAN sau auto-găzduite. Același API, implementat local.
Integrare cu
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Aplicații web personalizate
Aplicația dumneavoastră
ERP
HRMS
Salarizare
ERP școlar
Flux de lucru AI (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
Aplicații personalizate
Protocol Engine
Procesare securizată a autentificării
Înregistrarea tranzacțiilor de date
Translare de protocoale
Cache offline & coadă
Criptare AES-256 · Validare Auth Token
Strat Standardised API
Managementul identității
Integrare AI / MCP
Dispecer de callback-uri
Router de comenzi REST
Normalizarea datelor · Suport pentru protocoale multi-marcă
Amprentă
·
Recunoaștere facială
·
Venele palmei
·
Card RFID
·
PIN
·
Cod QR / cod de bare
·
Urmărire GPS
Dispozitive biometrice — toate mărcile sunt acceptate
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ multe altele
| Tip API | Direcție | Latență | Caz de utilizare |
|---|
| Callback API | Dispozitiv → Serverul dumneavoastră | În timp real / latență zero | Primiți pontări, evenimente de sincronizare a utilizatorilor |
| RESTful API | Serverul dumneavoastră → Dispozitiv | ~15 secunde | Adăugare/ștergere utilizatori, încărcare jurnale, înrolare date biometrice |
Introducere
Primii pași
Integrați în trei pași. Serverul dumneavoastră are nevoie de un URL accesibil public pentru a primi callback-uri.
1
Configurați Callback URL
Autentificați-vă în portalul API Monitor. Setați URL-ul HTTPS public al serverului dumneavoastră ca Callback URL pentru dispozitiv(e). Motorul API va trimite evenimentele biometrice prin POST către acest endpoint, în timp real.
2
Primiți pontările
Endpoint-ul dumneavoastră primește un POST cu un corp JSON brut — pentru Callback API nu sunt necesari parametri de interogare. Validați AuthToken, procesați datele pontării și răspundeți cu {"status":"done"}.
3
Apelați RESTful API pentru a gestiona utilizatorii & dispozitivele
Trimiteți prin POST o comandă JSON la URL-ul endpoint-ului RESTful furnizat în contul dumneavoastră API Monitor, cu stgid (Service Tag ID) ca parametru de interogare. Motorul pune comanda în coadă, iar dispozitivul o confirmă în aproximativ 15 secunde.
Formatul endpoint-ului
| Tip API | Metodă | Mod de trimitere |
|---|
| Callback API (de intrare) |
POST |
Dispozitivul trimite prin POST către URL-ul dumneavoastră configurat. Corp JSON brut; fără parametri. |
| RESTful API (de ieșire) |
POST |
Trimiteți POST la URL-ul endpoint-ului RESTful (găsit în contul dumneavoastră API Monitor) cu ?stgid=YOUR_SERVICE_TAG_ID și corp JSON brut. |
Răspundeți întotdeauna imediat la cererile Callback. Serverul dumneavoastră trebuie să returneze {"status":"done"} (HTTP 200) pentru a confirma primirea. Nu efectuați procesări grele înainte de a răspunde — puneți-le în coadă.
Documentație
Documentația API
Referința este împărțită pe subiecte. Începeți cu compatibilitatea dispozitivelor, apoi continuați cu operațiunile callback și REST.
Dispozitive acceptate și moduri de conectareCe dispozitive acceptă Gateway, cum se conectează fiecare (Native Push sau Hybrid Push) și ce operațiuni API sunt disponibile în fiecare mod.
Referință API: arhitectură, câmpuri și coduri de stareElementele comune tuturor operațiunilor: fluxul cererilor, câmpurile JSON comune, tipurile de șabloane, codurile de stare, porturile și criptarea payload-ului.
Callback API: evenimente în timp real de la dispozitiv către serverul dumneavoastrăFiecare eveniment trimis de un dispozitiv către callback URL-ul dumneavoastră, cu JSON-ul primit de server și răspunsul pe care trebuie să-l returneze.
RESTful API: comenzi de la serverul dumneavoastră către dispozitivComenzile pe care serverul dumneavoastră le trimite unui dispozitiv prin Gateway, cu JSON de cerere și de răspuns pentru fiecare.
Testarea API-ului localCum primiți callback-urile dispozitivelor pe un computer de dezvoltare și cum testați comenzile REST cu Postman înainte de implementare.
Exemplu PHP: stocarea pontajului biometric în MySQLUn handler de callback în PHP funcțional care stochează pontările în MySQL, în trei pași.
Prompturi pentru generatoare de cod AICopiați un prompt în asistentul dumneavoastră AI pentru a genera cod de integrare pentru propriul stack.
Întrebări frecvente, SDK și costuriÎntrebări frecvente ale integratorilor, plus modul în care funcționează SDK-ul și prețurile API.
