Strona główna / Produkty / API / Biometric Gateway Web API

API

Biometric Gateway Web API

Biometric Gateway Web API (znane też jako Universal Biometric Web API 3.0) zamienia dowolne obsługiwane urządzenie z odciskiem palca, twarzą, dłonią, żyłami, tęczówką, siatkówką, kartą lub hasłem w podłączony do chmury endpoint, z którym Twoja aplikacja może się komunikować z dowolnego miejsca na świecie. Odbieraj odbicia w czasie rzeczywistym w chwili ich wystąpienia i zarządzaj użytkownikami na urządzeniu zdalnie — wszystko przez prosty kontrakt REST plus Callback.

Zacznij Dokumentacja dla deweloperów

Przegląd

Podłącz dowolne biometryczne urządzenie do rejestracji obecności lub kontroli dostępu z dostępem do internetu bezpośrednio do aplikacji webowej przez HTTP — bez lokalnego oprogramowania, komputera ani bazy danych.

Flagowe Web API Cams umożliwia komunikację maszyna–serwer między zdalnie zainstalowanymi urządzeniami biometrycznymi a Twoją aplikacją serwerową. Urządzenie łączy się z internetem, obecność jest wysyłana na Twój adres Callback (webhook) w czasie rzeczywistym, a Twój serwer steruje operacjami na urządzeniu, takimi jak dodanie lub usunięcie użytkownika, wysyłanie wzorców, wysyłanie zdjęć i wczytywanie logów odbić, przez wywołania RESTful. Nie trzeba instalować oprogramowania desktopowego, uruchamiać lokalnej bazy danych ani utrzymywać komputera w sieci LAN. API jest niezależne od bazy danych i działa z dowolnym językiem backendu.

APIRESTCallback/Webhook (HTTP POST)MQTT (ścieżka trwałego połączenia EMQX)PHPPythonJavaNode.js

Używane w:Zarządzanie gośćmi Wydarzenia, festiwale i stadiony

Callback (webhook) — odbicie w czasie rzeczywistym

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

Możliwości

Co potrafi

Obecność w czasie rzeczywistym

Odbicia są wysyłane na Twój Callback URL w chwili zarejestrowania na urządzeniu.

Zdalne zarządzanie użytkownikami

Dodawaj, usuwaj, blokuj i przenoś użytkowników oraz wysyłaj wzorce lub zdjęcia na urządzenia z serwera przez wywołania RESTful.

Wielomodalna rejestracja

Jeden kontrakt obsługuje wejścia: odcisk palca, twarz, dłoń, żyły, tęczówkę, siatkówkę, kartę i hasło.

Odporność na tryb offline

Odbicia offline są buforowane na urządzeniu i odtwarzane w kolejności po przywróceniu łączności.

Szyfrowany transport

Szyfrowanie surowych danych AES-256 można włączyć dla każdego urządzenia, aby zabezpieczyć wymianę danych.

Funkcje

Wszystko w zestawie

Callback API (webhook) dostarcza odbicia obecności w czasie rzeczywistym z urządzenia na Twój serwer bez opóźnień odpytywania
API RESTful do operacji serwer–urządzenie: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog i inne (38 operacji)
Rejestruje wiele typów wejść przy każdym odbiciu: odcisk palca, twarz, kartę, dłoń, żyły palca, tęczówkę, siatkówkę, hasło oraz flagi temperatury ciała i maseczki, jeśli sprzęt je obsługuje
Typy odbić to CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
Obsługuje odbicia offline: dane z kolejki są przesyłane po kolei po ponownym połączeniu urządzenia
Opcjonalne szyfrowanie AES-256 wszystkich wymienianych surowych danych, z kluczem bezpieczeństwa ustawionym w API Monitor
LoadLog API pozwala aplikacjom bez serwera i działającym tylko w sieci LAN pobierać na żądanie do 30 dni historii obecności
Udokumentowane kody statusu dla niezawodnej obsługi błędów, z AuthToken dla każdego urządzenia i śledzeniem OperationID na potrzeby wsparcia i uzgodnień

Buduj z Biometric Gateway Web API

Weź klucz, przeczytaj dokumentację i wdrażaj. Nasz zespół pomoże przy pierwszej integracji.

Porozmawiaj z inżynierem WhatsApp

FAQ

Częste pytania

Czy muszę instalować jakiekolwiek oprogramowanie w sieci lokalnej, aby korzystać z Web API?

Nie. Komunikacja odbywa się przez HTTP między urządzeniem a Twoim serwerem. Dopóki urządzenie jest połączone z internetem, możesz odbierać obecność i zarządzać użytkownikami bez lokalnego oprogramowania, bazy danych ani komputera.

Jakie wejścia biometryczne obsługuje Web API?

Odcisk palca, twarz, kartę, dłoń, żyły palca, tęczówkę, siatkówkę i hasło, a także dane o temperaturze ciała i maseczce, jeśli udostępnia je sprzęt.

Jaka jest różnica między Callback API a API RESTful?

Callback API to komunikacja urządzenie–serwer w czasie rzeczywistym przez URL udostępniony na Twoim serwerze (bez opóźnień). API RESTful to komunikacja serwer–urządzenie, którą wywołujesz na endpoincie Cams, aby zarządzać urządzeniem, z opóźnieniem do ok. 15 sekund.

Czy mogę używać API, jeśli mój serwer nie ma publicznego IP?

Tak. Użyj LoadLog API, aby na żądanie pobierać logi obecności z wybranego przedziału czasu, o ile urządzenie jest połączone z internetem.