Giriş

Cams Biometric Gateway — Web API 3.0

The Cams Biometric Gateway is the universal Biometric API that connects any biometric attendance or access control machine with your application — ERP, HRMS, payroll, school management, custom software, or AI/automation workflow. It supports all major device brands and provides a standardised JSON-over-HTTP Biometric API regardless of the hardware.

38 İşlem — 11 Callback API (Cihaz → Sunucu) ve 27 RESTful API (Sunucu → Cihaz). Tüm payload'lar HTTP/HTTPS üzerinden ham JSON'dur.

Tüm biyometrik cihazlar desteklenir. Cams cihazları, doğrulanmış cihazlar ve üçüncü taraf markalar (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC ve daha fazlası). Kurulumunuza uygun bağlantı modunu seçin.

Nasıl Çalışır

Biometric Gateway şunlardan oluşur:

Gateway SunucusuCams Protocol Engine (protokol çevirisi, veri normalleştirme, çevrimdışı önbellekleme, kimlik doğrulama) ve uygulamanıza tutarlı bir arayüz sunan Standartlaştırılmış API katmanını içeren bulut tabanlı platform.

Protocol EngineGateway Sunucusu içinde biyometrik cihazlarla iletişim kuran, üreticiye özgü protokolleri çeviren ve güvenli veri işlem günlüğü ile kimlik yönetimini yürüten çekirdek motor.

Protocol Engine LiteYalnızca yerel ağ (LAN) veya kendi barındırdığınız ortamlar için kendi sunucunuza (Windows/Linux) kurulabilen şirket içi sürüm. Aynı API, yerel olarak dağıtılır.

Entegre Olduğu Sistemler

OdooERPNextSAPMicrosoft Dynamics ZohoBitrix24 OrangeHRMBayZatPalmHRuKnowva FedenaTeachmintEduBricz RazorPayPayruler n8nMakeZapier Claude (MCP)GeminiChatGPT Özel Web Uygulamaları

Uygulamanız

ERP İK Sistemi (HRMS) Bordro Okul ERP Yapay Zeka İş Akışı (n8n, Zapier) MCP — Claude · Gemini · ChatGPT Özel Uygulamalar

↑ Callback API Gateway → Sunucunuz (Push)

↓ RESTful API Sunucunuz → Gateway (Komut)

Biometric Gateway

Protocol Engine

Güvenli Kimlik Doğrulama İşleme Veri İşlem Günlüğü Protokol Çevirisi Çevrimdışı Önbellek ve Kuyruk AES-256 Şifreleme · Auth Token Doğrulama

Standartlaştırılmış API Katmanı

Kimlik Yönetimi Yapay Zeka / MCP Entegrasyonu Callback Dağıtıcı REST Komut Yönlendirici Veri Normalleştirme · Çoklu Marka Protokol Desteği

İnternet

Parmak İzi · Yüz Tanıma · Avuç İçi Damar · RFID Kart · PIN · QR / Barkod · GPS Takibi

Biyometrik Cihazlar — Tüm Markalar Desteklenir

Cams ZKTeco Suprema Hikvision Anviz Morpho / IDEMIA Virdi Mantra Nitgen Realtime Biomax Secugen eSSL Matrix + Daha Fazlası

API Türü	Yön	Gecikme	Kullanım Amacı
Callback API	Cihaz → Sunucunuz	Gerçek zamanlı / sıfır gecikme	Devam okutmalarını ve kullanıcı senkronizasyon olaylarını alın
RESTful API	Sunucunuz → Cihaz	~15 saniye	Kullanıcı ekleme/silme, log yükleme, biyometrik kayıt

Giriş

Başlarken

Üç adımda entegre olun. Callback'leri almak için sunucunuzun herkese açık erişilebilir bir URL'ye ihtiyacı vardır.

1

Callback URL'nizi yapılandırın

API Monitor portalına giriş yapın. Sunucunuzun herkese açık HTTPS URL'sini cihazlarınız için Callback URL olarak ayarlayın. API motoru, biyometrik olayları bu uç noktaya gerçek zamanlı olarak POST eder.

2

Devam okutmalarını alın

Uç noktanız ham JSON gövdeli bir POST alır — Callback API'leri için sorgu parametresi gerekmez. AuthToken değerini doğrulayın, okutma verisini ayrıştırın ve {"status":"done"} ile yanıt verin.

3

Kullanıcıları ve cihazları yönetmek için RESTful API'leri çağırın

API Monitor hesabınızda verilen RESTful uç nokta URL'sine, stgid (Service Tag ID) değerini sorgu parametresi olarak ekleyerek bir JSON komutu POST edin. Motor komutu kuyruğa alır ve cihaz ~15 saniye içinde onaylar.

Uç Nokta Biçimi

API Türü	Yöntem	Nasıl gönderilir
Callback API (gelen)	POST	Cihaz, sizin yapılandırdığınız URL'ye gönderir. Ham JSON gövde; parametre yok.
RESTful API (giden)	POST	RESTful uç nokta URL'sine (API Monitor hesabınızda bulunur) `?stgid=YOUR_SERVICE_TAG_ID` ile ve ham JSON gövdeyle POST edersiniz.

Callback isteklerine her zaman hemen yanıt verin. Sunucunuz alındığını onaylamak için {"status":"done"} (HTTP 200) döndürmelidir. Yanıt vermeden önce ağır işlem yapmayın — kuyruğa alın.

Dokümantasyon

API dokümantasyonu

Referans konulara göre bölünmüştür. Önce cihaz uyumluluğuyla başlayın, ardından callback ve REST işlemlerine geçin.

Desteklenen cihazlar ve bağlantı modlarıGateway'in hangi cihazları desteklediği, her birinin nasıl bağlandığı (Native Push veya Hybrid Push) ve her modda hangi API işlemlerinin kullanılabildiği. API referansı: mimari, alanlar ve durum kodlarıHer işlemde ortak olan yapı taşları: istek akışı, ortak JSON alanları, şablon türleri, durum kodları, portlar ve payload şifreleme. Callback API'leri: cihazdan sunucunuza gerçek zamanlı olaylarBir cihazın callback URL'nize gönderdiği her olay; sunucunuzun aldığı JSON ve döndürmesi gereken yanıtla birlikte. RESTful API'ler: sunucunuzdan cihaza komutlarSunucunuzun Gateway üzerinden cihaza gönderdiği komutlar; her biri için istek ve yanıt JSON'u ile. API'yi yerel ortamda test etmeYayına almadan önce geliştirme makinesinde cihaz callback'lerini nasıl alacağınız ve REST komutlarını Postman ile nasıl test edeceğiniz. PHP örneği: biyometrik devam verisini MySQL'de saklamaDevam okutmalarını MySQL'e kaydeden, çalışan bir PHP callback işleyicisi; üç adımda. Yapay zeka kod üretici promptlarıKendi teknoloji yığınınız için entegrasyon kodu üretmek üzere bir promptu yapay zeka asistanınıza kopyalayın. SSS, SDK ve maliyetEntegratörlerden gelen sık sorulan sorular; ayrıca SDK ve API fiyatlandırmasının nasıl işlediği.

Ek Bilgiler

Bize Ulaşın

API desteği, cihaz uyumluluğu veya satış soruları için:

Satış ve Destek

E-postasales@camsbiometrics.com

WhatsApp+91-98-409-21006 (Destek)

Satış+91-98-409-41006

Geliştirici Kaynakları

Forumforum.camsbiometrics.com

Cihazlardeveloper.camsbiometrics.com

Ürünlercamsbiometrics.com/product

Cams Biometrics (Dheeram Innovations Pvt Ltd) — No: 2/98D, 2. Kat, Cams Biometrics Binası, Satyabama Üniversitesi Karşısı, Semmancheri, OMR, Chennai – 600119, Hindistan.