Home / Producten / API's / Biometric Gateway Web API

API

Biometric Gateway Web API

De Biometric Gateway Web API (ook bekend als de Universal Biometric Web API 3.0) maakt van elk ondersteund vingerafdruk-, gezichts-, handpalm-, ader-, iris-, retina-, kaart- of wachtwoordapparaat een cloudverbonden endpoint waarmee uw applicatie vanaf elke plek ter wereld kan communiceren. Ontvang punches op het moment dat ze plaatsvinden en beheer gebruikers op het apparaat op afstand, allemaal via een eenvoudig REST- plus Callback-contract.

Aan de slag Developerdocs

Overzicht

Koppel elk biometrisch aanwezigheids- of toegangscontroleapparaat met internetverbinding rechtstreeks via HTTP aan uw webapplicatie — geen lokale software, pc of database nodig.

De vlaggenschip-Web API van Cams maakt machine-naar-servercommunicatie mogelijk tussen op afstand geïnstalleerde biometrische apparaten en uw serverapplicatie. Een apparaat maakt verbinding met internet, aanwezigheid wordt in realtime gepusht naar uw Callback-URL (webhook) en uw server stuurt apparaatoperaties aan zoals gebruiker toevoegen of verwijderen, sjablonen pushen, foto's pushen en punchlogs laden via RESTful-aanroepen. U hoeft geen desktopsoftware te installeren, geen lokale database te draaien en geen pc in het LAN aan te laten staan. De API is database-onafhankelijk en werkt met elke backendtaal.

APIRESTCallback/Webhook (HTTP POST)MQTT (EMQX-pad met permanente verbinding)PHPPythonJavaNode.js

Gebruikt in:Bezoekersbeheer Evenementen, festivals en stadions

Callback (webhook) — realtime punch

# 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"
}

Mogelijkheden

Wat het doet

Realtime aanwezigheid

Punches worden naar uw Callback-URL gepusht op het moment dat ze op het apparaat worden vastgelegd.

Gebruikersbeheer op afstand

Voeg gebruikers toe, verwijder, blokkeer en verplaats ze en push sjablonen of foto's naar apparaten vanaf uw server via RESTful-aanroepen.

Multimodale opname

Eén contract verwerkt invoer van vingerafdruk, gezicht, handpalm, ader, iris, retina, kaart en wachtwoord.

Offline robuustheid

Offline punches worden op het apparaat gebufferd en in volgorde opnieuw afgespeeld zodra de verbinding is hersteld.

Versleuteld transport

AES-256-versleuteling van ruwe data kan per apparaat worden ingeschakeld voor veilige data-uitwisseling.

Functies

Alles inbegrepen

De Callback-API (webhook) levert realtime aanwezigheidspunches van apparaat naar uw server zonder polling-latentie
RESTful API voor server-naar-apparaatoperaties: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog en meer (38 operaties)
Legt meerdere invoertypen per punch vast: vingerafdruk, gezicht, kaart, handpalm, vingerader, iris, retina, wachtwoord, plus vlaggen voor lichaamstemperatuur en mondkapje waar de hardware dat ondersteunt
Punchtypen zijn onder meer CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
Verwerkt offline punches: data in de wachtrij wordt in volgorde verzonden wanneer het apparaat opnieuw verbinding maakt
Optionele AES-256-versleuteling van alle uitgewisselde ruwe data, met een beveiligingssleutel die in de API Monitor wordt ingesteld
Met de LoadLog API kunnen niet-serverapplicaties en applicaties die alleen op het LAN draaien op aanvraag tot 30 dagen aanwezigheidsgeschiedenis ophalen
Gedocumenteerde statuscodes voor robuuste foutafhandeling, met AuthToken per apparaat en OperationID-tracering voor support en afstemming

Bouw met Biometric Gateway Web API

Haal een sleutel op, lees de docs en ga live. Ons team helpt u bij uw eerste integratie.

Praat met een engineer WhatsApp

FAQ

Veelgestelde vragen

Moet ik software op mijn lokale netwerk installeren om de Web API te gebruiken?

Nee. De communicatie verloopt via HTTP tussen het apparaat en uw server. Zolang het apparaat met internet is verbonden, kunt u aanwezigheid ontvangen en gebruikers beheren zonder lokale software, database of pc.

Welke biometrische invoer ondersteunt de Web API?

Vingerafdruk, gezicht, kaart, handpalm, vingerader, iris, retina en wachtwoord, plus gegevens over lichaamstemperatuur en mondkapje waar de hardware die levert.

Wat is het verschil tussen de Callback-API en de RESTful API?

De Callback-API is realtime communicatie van apparaat naar server via een URL die u op uw server beschikbaar stelt (geen latentie). De RESTful API is communicatie van server naar apparaat die u aanroept op het endpoint van Cams om het apparaat te beheren, met een latentie van maximaal ongeveer 15 seconden.

Kan ik de API gebruiken als mijn server geen openbaar IP-adres heeft?

Ja. Gebruik de LoadLog API om aanwezigheidslogs voor een bepaalde periode op aanvraag op te halen, zolang het apparaat met internet is verbonden.