Ana sayfa / Ürünler / API'ler / Biometric Gateway Web API

API

Biometric Gateway Web API

Biometric Gateway Web API (Universal Biometric Web API 3.0 olarak da bilinir), desteklenen her parmak izi, yüz, avuç içi, damar, iris, retina, kart veya parola cihazını, uygulamanızın dünyanın her yerinden konuşabileceği bulut bağlantılı bir endpoint'e dönüştürür. Gerçek zamanlı giriş-çıkışları gerçekleştiği anda alın ve cihazdaki kullanıcıları uzaktan yönetin — hepsi basit bir REST artı Callback sözleşmesi üzerinden.

Başlayın Geliştirici dokümanları

Genel bakış

İnternete bağlı herhangi bir biyometrik devam veya erişim kontrol cihazını doğrudan web uygulamanıza HTTP üzerinden bağlayın — yerel yazılım, PC veya veritabanı gerekmez.

Cams'in amiral gemisi Web API'si, uzaktan kurulmuş biyometrik cihazlar ile sunucu uygulamanız arasında makineden sunucuya iletişim sağlar. Bir cihaz internete bağlanır, devam verisi Callback (webhook) URL'nize gerçek zamanlı iletilir ve sunucunuz kullanıcı ekleme veya silme, şablon gönderme, fotoğraf gönderme ve giriş-çıkış kayıtlarını yükleme gibi cihaz işlemlerini RESTful çağrılarla yönetir. Masaüstü yazılımı kurmaya, yerel veritabanı çalıştırmaya veya LAN'da bir PC açık tutmaya gerek yoktur. API veritabanından bağımsızdır ve her arka uç diliyle çalışır.

APIRESTCallback/Webhook (HTTP POST)MQTT (EMQX kalıcı bağlantı yolu)PHPPythonJavaNode.js

Kullanıldığı yerler:Ziyaretçi Yönetimi Etkinlikler, Festivaller ve Stadyumlar

Callback (webhook) — gerçek zamanlı giriş-çıkış

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

Yetenekler

Neler yapar

Gerçek Zamanlı Devam

Giriş-çıkışlar, cihazda kaydedildiği anda Callback URL'nize iletilir.

Uzaktan Kullanıcı Yönetimi

Sunucunuzdan RESTful çağrılarla kullanıcı ekleyin, silin, engelleyin ve taşıyın; cihazlara şablon veya fotoğraf gönderin.

Çok Yöntemli Yakalama

Tek sözleşme; parmak izi, yüz, avuç içi, damar, iris, retina, kart ve parola girişlerini yönetir.

Çevrimdışı Dayanıklılık

Çevrimdışı giriş-çıkışlar cihazda tamponlanır ve bağlantı geri geldiğinde sırayla yeniden iletilir.

Şifreli Aktarım

Güvenli veri alışverişi için cihaz bazında AES-256 ham veri şifrelemesi etkinleştirilebilir.

Özellikler

Her şey dahil

Callback (webhook) API, polling gecikmesi olmadan gerçek zamanlı devam giriş-çıkışlarını cihazdan sunucunuza iletir
Sunucudan cihaza işlemler için RESTful API: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog ve daha fazlası (38 işlem)
Her giriş-çıkışta birden fazla giriş türü yakalar: Parmak İzi, Yüz, Kart, Avuç İçi, Parmak Damarı, İris, Retina, Parola; donanım destekliyorsa ayrıca Vücut Sıcaklığı ve Yüz Maskesi bayrakları
Giriş-çıkış türleri: CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
Çevrimdışı giriş-çıkışları yönetir: kuyruğa alınan veriler cihaz yeniden bağlandığında sırayla iletilir
API Monitor'da belirlenen güvenlik anahtarıyla, değiştirilen tüm ham verinin isteğe bağlı AES-256 şifrelemesi
LoadLog API, sunucusuz ve yalnızca LAN'daki uygulamaların istendiğinde 30 güne kadar devam geçmişini çekmesini sağlar
Sağlam hata yönetimi için belgelenmiş durum kodları; destek ve mutabakat için cihaz bazında AuthToken ve OperationID izleme

Biometric Gateway Web API ile geliştirin

Bir anahtar alın, dokümanları okuyun ve yayına alın. Ekibimiz ilk entegrasyonunuzda yardımcı olur.

Bir mühendisle görüşün WhatsApp

SSS

Sık sorulan sorular

Web API'yi kullanmak için yerel ağıma herhangi bir yazılım kurmam gerekir mi?

Hayır. İletişim, cihaz ile sunucunuz arasında HTTP üzerinden gerçekleşir. Cihaz internete bağlı olduğu sürece, yerel yazılım, veritabanı veya PC olmadan devam verisini alabilir ve kullanıcıları yönetebilirsiniz.

Web API hangi biyometrik girişleri destekler?

Parmak İzi, Yüz, Kart, Avuç İçi, Parmak Damarı, İris, Retina ve Parola; donanım sağlıyorsa ayrıca Vücut Sıcaklığı ve Yüz Maskesi verileri.

Callback API ile RESTful API arasındaki fark nedir?

Callback API, sunucunuzda açtığınız bir URL üzerinden gerçek zamanlı cihazdan sunucuya iletişimdir (gecikmesiz). RESTful API ise cihazı yönetmek için Cams'in endpoint'ini çağırdığınız sunucudan cihaza iletişimdir; gecikme yaklaşık 15 saniyeye kadar çıkabilir.

Sunucumun genel IP'si yoksa API'yi kullanabilir miyim?

Evet. Cihaz internete bağlı olduğu sürece, belirli bir zaman aralığındaki devam kayıtlarını istendiğinde çekmek için LoadLog API'yi kullanın.