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
↑ Callback API Gateway → Serverul dumneavoastră (Push)
↓ RESTful API Serverul dumneavoastră → Gateway (comandă)
Biometric Gateway
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ă
Internet
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
Toată comunicarea este JSON prin HTTP/HTTPS  ·  Criptare AES-256 opțională  ·  www.camsbiometrics.com
Tip APIDirecțieLatențăCaz de utilizare
Callback APIDispozitiv → Serverul dumneavoastrăÎn timp real / latență zeroPrimiți pontări, evenimente de sincronizare a utilizatorilor
RESTful APIServerul dumneavoastră → Dispozitiv~15 secundeAdă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 APIMetodă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.
Informații suplimentare

Contact

Pentru suport API, compatibilitatea dispozitivelor sau solicitări comerciale:

Vânzări & suport

E-mailsales@camsbiometrics.com
WhatsApp+91-98-409-81006 (Suport)
Vânzări+91-98-409-41006

Resurse pentru dezvoltatori

Forumforum.camsbiometrics.com
Dispozitivedeveloper.camsbiometrics.com
Produsecamsbiometrics.com/product

Cams Biometrics (Dheeram Innovations Pvt Ltd) — No: 2/98D, 2nd Floor, Cams Biometrics Building, Opposite to Satyabama University, Semmancheri, OMR, Chennai – 600119, India.

Utilizări

Cantină fără numerarIdentificați fiecare client prin față sau amprentă, scădeți automat subvenția de masă și opriți mâncatul în locul altei persoane.See the solution →ȘantierePontaj fără atingere, rezistent la praf și mănuși, care alimentează ERP-ul și salarizarea dumneavoastră.See the solution →Flotă, transport și șoferiVerificați identitatea șoferului la depou sau în cabină și păstrați un jurnal al orelor de serviciu pentru TMS și salarizare.See the solution →Stivuitoare și manipulare de materialeDoar operatorii certificați pot porni vehiculul. Fiecare pornire și fiecare refuz sunt înregistrate.See the solution →Săli de sport, cluburi și fitnessCheck-in fără atingere pentru membri, abonament validat, turnichet sau ușă deschisă.See the solution →Gestionarea vizitatorilorCheck-in facial la recepție, cu acces care expiră automat și jurnal de audit complet.See the solution →Școli, colegii și campusuriPrezență fără atingere pentru elevi și personal, sincronizată în timp real cu software-ul școlii.See the solution →Evenimente, festivaluri și stadioaneAcces prin față sau brățară, conectat la turnichete și bariere, cu numărătoare în timp real la fiecare poartă.See the solution →