SSS, SDK ve maliyet
Entegratörlerden gelen sık sorulan sorular; ayrıca SDK ve API fiyatlandırmasının nasıl işlediği.
Ek Bilgiler
Sık Sorulan Sorular
Cams Biometrics Web API 3.0 ile entegrasyona dair sık sorulan sorular.
Genel
S: Cams Biometric Gateway ve Biyometrik API'si nedir?
Cams Biometric Gateway, herhangi bir web uygulamasının biyometrik devam ve geçiş kontrol cihazlarıyla gerçek zamanlı iletişim kurmasını sağlayan bir Biyometrik API sunan evrensel bir bulut platformudur. Callback (gelen) ve RESTful (giden) API'ler genelinde 38 işlemi destekler — herhangi bir cihaz SDK'sı veya statik IP gerektirmeden.
Cams Biometric Gateway, herhangi bir web uygulamasının biyometrik devam ve geçiş kontrol cihazlarıyla gerçek zamanlı iletişim kurmasını sağlayan bir Biyometrik API sunan evrensel bir bulut platformudur. Callback (gelen) ve RESTful (giden) API'ler genelinde 38 işlemi destekler — herhangi bir cihaz SDK'sı veya statik IP gerektirmeden.
S: Entegrasyon için bir SDK'ya ihtiyacım var mı?
Hayır. Cams bir SDK sunmaz ve gerektirmez. Tüm iletişim, JSON payload'lı standart HTTP/HTTPS POST istekleriyle yapılır. HTTP çağrısı yapabilen her dil çalışır.
Hayır. Cams bir SDK sunmaz ve gerektirmez. Tüm iletişim, JSON payload'lı standart HTTP/HTTPS POST istekleriyle yapılır. HTTP çağrısı yapabilen her dil çalışır.
S: Hangi programlama dilleri destekleniyor?
JSON içeren HTTP POST gönderip alabilen her dil — PHP, Python, Java, C#, Node.js, Go, Ruby ve daha fazlası. 7 dil için yapay zeka kod üretici promptları sunuyoruz.
JSON içeren HTTP POST gönderip alabilen her dil — PHP, Python, Java, C#, Node.js, Go, Ruby ve daha fazlası. 7 dil için yapay zeka kod üretici promptları sunuyoruz.
S: Cams Protocol Engine nedir?
Biyometrik cihazlarla sunucunuz arasında yer alan bulut ara katman yazılımıdır. Protokol çevirisini, veri normalleştirmeyi ve çevrimdışı önbelleklemeyi yönetir; altta yatan cihaz markası veya modelinden bağımsız olarak tutarlı bir JSON API sunar.
Biyometrik cihazlarla sunucunuz arasında yer alan bulut ara katman yazılımıdır. Protokol çevirisini, veri normalleştirmeyi ve çevrimdışı önbelleklemeyi yönetir; altta yatan cihaz markası veya modelinden bağımsız olarak tutarlı bir JSON API sunar.
S: API Monitor nedir?
API Monitor; Callback URL'lerini yapılandırdığınız, AuthToken'ları yönettiğiniz, Güvenlik Anahtarlarını belirlediğiniz, cihaz durumunu görüntülediğiniz ve RESTful uç nokta URL'nize ile Service Tag ID'lerinize eriştiğiniz yönetim portalınızdır.
API Monitor; Callback URL'lerini yapılandırdığınız, AuthToken'ları yönettiğiniz, Güvenlik Anahtarlarını belirlediğiniz, cihaz durumunu görüntülediğiniz ve RESTful uç nokta URL'nize ile Service Tag ID'lerinize eriştiğiniz yönetim portalınızdır.
Cihaz Uyumluluğu
S: Hangi biyometrik cihazlar destekleniyor?
Tüm Cams Biometrics cihazları (camsbiometrics.com/product adresinde listelenir) Native Push ile tam API'yi destekler. developer.camsbiometrics.com adresinde doğrulanmış cihazlar da tam Native Push desteğine sahiptir.
Tüm Cams Biometrics cihazları (camsbiometrics.com/product adresinde listelenir) Native Push ile tam API'yi destekler. developer.camsbiometrics.com adresinde doğrulanmış cihazlar da tam Native Push desteğine sahiptir.
S: Cams olmayan cihazlar (ZkTeco, eSSL, BioMax vb.) bu API'yi kullanabilir mi?
Evet, bir Protokol Güncellemesi ile. Cams olmayan ve doğrulanmamış cihazlar Hybrid Push ile çalışır. Bazı özellikler bağlantı moduna ve donanım yeteneklerine bağlı olarak sınırlı olabilir.
Evet, bir Protokol Güncellemesi ile. Cams olmayan ve doğrulanmamış cihazlar Hybrid Push ile çalışır. Bazı özellikler bağlantı moduna ve donanım yeteneklerine bağlı olarak sınırlı olabilir.
S: Native Push ile Hybrid Push arasındaki fark nedir?
Native Push: Sınırlama olmadan tam API desteği — 38 işlemin tamamı çalışır. Cams cihazları ve doğrulanmış cihazlar için kullanılabilir.
Hybrid Push: Cams olmayan/doğrulanmamış cihazlar için. Özellik kullanılabilirliği iletişim moduna (SDK, DB Pull veya Dosya İşleme) bağlıdır. Bkz. Bağlantı Modları.
Native Push: Sınırlama olmadan tam API desteği — 38 işlemin tamamı çalışır. Cams cihazları ve doğrulanmış cihazlar için kullanılabilir.
Hybrid Push: Cams olmayan/doğrulanmamış cihazlar için. Özellik kullanılabilirliği iletişim moduna (SDK, DB Pull veya Dosya İşleme) bağlıdır. Bkz. Bağlantı Modları.
S: Hangi biyometrik yöntemler destekleniyor?
Parmak izi, yüz tanıma, avuç içi damar, RFID/yakınlık kartı, sayısal PIN/parola, iris tarama ve vücut sıcaklığı ölçümü (cihaza bağlı).
Parmak izi, yüz tanıma, avuç içi damar, RFID/yakınlık kartı, sayısal PIN/parola, iris tarama ve vücut sıcaklığı ölçümü (cihaza bağlı).
S: Bazı API özellikleri cihazımda çalışmıyor. Neden?
Bu (a) bağlantı moduna — DB Pull ve Dosya İşleme modları yalnızca devam push'unu destekler, RESTful API'leri desteklemez — ve (b) donanım sınırlamalarına bağlıdır — bazı cihaz modelleri belirli özellikleri yazılım düzeyinde desteklemeyebilir. Donanımınızla test edin ve yardım için Cams desteğiyle iletişime geçin.
Bu (a) bağlantı moduna — DB Pull ve Dosya İşleme modları yalnızca devam push'unu destekler, RESTful API'leri desteklemez — ve (b) donanım sınırlamalarına bağlıdır — bazı cihaz modelleri belirli özellikleri yazılım düzeyinde desteklemeyebilir. Donanımınızla test edin ve yardım için Cams desteğiyle iletişime geçin.
Callback API (Cihaz → Sunucu)
S: Callback API nedir?
Callback API, biyometrik cihazlardan sunucunuza gerçek zamanlı olayları iletir. Cihazda bir okutma gerçekleştiğinde veya bir kullanıcı değiştirildiğinde, Cams Protocol Engine yapılandırdığınız Callback URL'sine hemen bir JSON payload POST eder.
Callback API, biyometrik cihazlardan sunucunuza gerçek zamanlı olayları iletir. Cihazda bir okutma gerçekleştiğinde veya bir kullanıcı değiştirildiğinde, Cams Protocol Engine yapılandırdığınız Callback URL'sine hemen bir JSON payload POST eder.
S: Sunucum ne ile yanıt vermeli?
Dahili işleminiz başarısız olsa bile her zaman HTTP durumu 200 ile
Dahili işleminiz başarısız olsa bile her zaman HTTP durumu 200 ile
{"status":"done"} döndürün. Cams Protocol Engine'i asla bloke etmeyin. Ağır işlemleri asenkron çalıştırmak üzere kuyruğa alın.S: Okutma sırasında sunucum çevrimdışıysa ne olur?
Biometric Gateway tüm olayları önbelleğe alır ve sunucunuz tekrar çevrimiçi olduğunda otomatik olarak iletir. Hiçbir veri kaybolmaz.
Biometric Gateway tüm olayları önbelleğe alır ve sunucunuz tekrar çevrimiçi olduğunda otomatik olarak iletir. Hiçbir veri kaybolmaz.
S: Yinelenen okutmaları nasıl ele alırım?
Sunucunuzda
Sunucunuzda
UserID + LogTime birleşimini kullanarak yinelenen kayıt tespiti mantığı uygulayın. Aynı okutma, çevrimdışı kurtarma veya ağ yeniden denemeleri sırasında tekrar gönderilebilir.S: Hangi okutma türleri destekleniyor?
CheckIn, CheckOut, BreakOut, BreakIn, OverTimeIn, OverTimeOut, MealIn, MealOut. InputType alanı kullanılan biyometrik yöntemi gösterir: Fingerprint, Face, Palm, Card veya Password.Q: How do user templates work in Callbacks?
When a user is updated on the device (operations #3–#9), templates may arrive one at a time or in groups across multiple callbacks. Each callback only carries templates that changed — not the full set. Your server must merge/upsert by
When a user is updated on the device (operations #3–#9), templates may arrive one at a time or in groups across multiple callbacks. Each callback only carries templates that changed — not the full set. Your server must merge/upsert by
Type + Index as the unique key. Never overwrite all templates on a single callback.S: Devam fotoğraflarını alabilir miyim?
Evet. #10 RealTimeAttendancePhoto işlemi, okutma anında yakalanan Base64 kodlu bir JPEG anlık görüntüsü iletir. Bu, okutma logu callback'inden (#11) ayrıdır ve kamera desteği olan cihazlarda kullanılabilir.
Evet. #10 RealTimeAttendancePhoto işlemi, okutma anında yakalanan Base64 kodlu bir JPEG anlık görüntüsü iletir. Bu, okutma logu callback'inden (#11) ayrıdır ve kamera desteği olan cihazlarda kullanılabilir.
S: Callback sıcaklık ve maske algılamayı içeriyor mu?
Evet, cihaz destekliyorsa.
Evet, cihaz destekliyorsa.
PunchLog nesnesi Temperature (vücut sıcaklığı değeri) ve FaceMask (boolean — yüz maskesinin algılanıp algılanmadığı) içerir.RESTful API (Sunucu → Cihaz)
S: RESTful API nedir?
RESTful API, sunucunuzun biyometrik cihazlara komut göndermesini sağlar — kullanıcı ekleme/silme, log yükleme, biyometrik kayıt ve erişim kontrolü. API Monitor hesabınızda bulunan uç nokta URL'sine JSON POST edersiniz.
RESTful API, sunucunuzun biyometrik cihazlara komut göndermesini sağlar — kullanıcı ekleme/silme, log yükleme, biyometrik kayıt ve erişim kontrolü. API Monitor hesabınızda bulunan uç nokta URL'sine JSON POST edersiniz.
S: RESTful uç nokta URL'mi nerede bulurum?
API Monitor hesabınıza giriş yapın. RESTful uç nokta URL'niz ve Service Tag ID'leriniz (
API Monitor hesabınıza giriş yapın. RESTful uç nokta URL'niz ve Service Tag ID'leriniz (
stgid) orada listelenir.S: RESTful komutlarda gecikme nedir?
Yaklaşık 15 saniye. Biometric Gateway komutunuzu kuyruğa alır ve cihaz bir sonraki bağlanışında ona iletir (çevrimiçi cihazlar için neredeyse süreklidir).
Yaklaşık 15 saniye. Biometric Gateway komutunuzu kuyruğa alır ve cihaz bir sonraki bağlanışında ona iletir (çevrimiçi cihazlar için neredeyse süreklidir).
S: LoadLog için azami tarih aralığı nedir?
İstek başına önerilen azami aralık 30 gündür. Daha geniş aralıklar için ardışık zaman pencereleriyle birden fazla istek yapın.
İstek başına önerilen azami aralık 30 gündür. Daha geniş aralıklar için ardışık zaman pencereleriyle birden fazla istek yapın.
S: Birden fazla biyometrik şablonla tek seferde kullanıcı ekleyebilir miyim?
Evet. Template dizisi birden fazla giriş kabul eder. Örneğin #27 işlemi, Kart + Parmak İzi + Parola + Yüz + Avuç İçi + UserPhoto ile bir kullanıcıyı tek istekte ekler.
Evet. Template dizisi birden fazla giriş kabul eder. Örneğin #27 işlemi, Kart + Parmak İzi + Parola + Yüz + Avuç İçi + UserPhoto ile bir kullanıcıyı tek istekte ekler.
S: RESTful komut gönderdiğimde cihaz çevrimdışıysa ne olur?
Biometric Gateway komutu kuyruğa alır ve cihaz yeniden bağlandığında otomatik olarak iletir. Cihaz zaman aşımı süresi içinde yanıt vermezse
Biometric Gateway komutu kuyruğa alır ve cihaz yeniden bağlandığında otomatik olarak iletir. Cihaz zaman aşımı süresi içinde yanıt vermezse
5 durum kodunu (Cihaz Çevrimdışı) alırsınız.S: Komut sonucunu nasıl kontrol ederim?
RESTful yanıtlar bir
RESTful yanıtlar bir
StatusCode alanı içerir. 0 kodu başarı anlamına gelir. Hata kodlarının ve anlamlarının tam listesi için Yanıt Durum Kodları'na bakın.S: Parmak izi kaydını uzaktan tetikleyebilir miyim?
Evet. #35 EnrollFingerPrint işlemi, cihaz üzerinde bir kayıt oturumu tetikler. Ancak kullanıcının parmağını taramak için cihazın başında fiziksel olarak bulunması gerekir.
Evet. #35 EnrollFingerPrint işlemi, cihaz üzerinde bir kayıt oturumu tetikler. Ancak kullanıcının parmağını taramak için cihazın başında fiziksel olarak bulunması gerekir.
Güvenlik ve Ağ
S: Callback'ler için HTTPS kullanabilir miyim?
Evet. 443 numaralı portta geçerli SSL sertifikalı HTTPS tam olarak desteklenir ve üretim için önerilir.
Evet. 443 numaralı portta geçerli SSL sertifikalı HTTPS tam olarak desteklenir ve üretim için önerilir.
S: Şifreleme zorunlu mu?
Hayır. AES-256 şifreleme isteğe bağlıdır. Etkinleştirmek için API Monitor'da bir Güvenlik Anahtarı yapılandırın. Etkinleştirildiğinde tüm JSON payload'ları Base64 kodlamayla AES/ECB/PKCS5PADDING kullanılarak şifrelenir/çözülür.
Hayır. AES-256 şifreleme isteğe bağlıdır. Etkinleştirmek için API Monitor'da bir Güvenlik Anahtarı yapılandırın. Etkinleştirildiğinde tüm JSON payload'ları Base64 kodlamayla AES/ECB/PKCS5PADDING kullanılarak şifrelenir/çözülür.
S: Bir callback'in gerçekten Cams'ten geldiğini nasıl doğrularım?
Her callback bir
Her callback bir
AuthToken alanı içerir. Bunu API Monitor'da yapılandırdığınız token ile karşılaştırın. Token'ı eşleşmeyen her isteği reddedin.S: Hangi portları açmalıyım?
Üretim için
Üretim için
80 (HTTP) veya 443 (HTTPS) portu. 8123 portu yalnızca test için kullanılabilir. Bkz. Desteklenen Portlar.S: Sunucuya dağıtım yapmadan yerel ortamda nasıl test ederim?
Port yönlendirmeli herkese açık bir IP veya ngrok gibi bir tünelleme aracı kullanın. Adım adım kılavuz için Yerel Ortamda Test'e bakın.
Port yönlendirmeli herkese açık bir IP veya ngrok gibi bir tünelleme aracı kullanın. Adım adım kılavuz için Yerel Ortamda Test'e bakın.
Veri ve Tasarım Hususları
S: API hangi veri biçimini kullanıyor?
Tüm istek ve yanıtlar UTF-8 kodlamalı ham JSON'dur.
Tüm istek ve yanıtlar UTF-8 kodlamalı ham JSON'dur.
Content-Type: application/json başlığını kullanın. Form kodlaması yoktur.S: Hangi zaman damgası biçimi kullanılıyor?
YYYY-MM-DD HH:mm:ss GMT +OFFSET (örn. 2020-09-17 07:48:22 GMT +0530). Time alanı UTC'dir; cihaz yerel zaman damgaları (LogTime, OperationTime gibi) farklı bir saat dilimi farkı kullanabilir.S: Çevrimdışı okutmaları ve geriye dönük verileri nasıl ele almalıyım?
Uygulamanızı kronolojik sıra dışında gelen okutmaları kabul edecek şekilde tasarlayın. Bir cihaz çevrimdışı kaldıysa, yeniden bağlandığında önbelleğe alınmış okutmaları push eder. Devam durumunu geriye dönük olarak güncellemeniz gerekebilir (örn. "yok" görünen bir kullanıcıyı "var" olarak işaretlemek).
Uygulamanızı kronolojik sıra dışında gelen okutmaları kabul edecek şekilde tasarlayın. Bir cihaz çevrimdışı kaldıysa, yeniden bağlandığında önbelleğe alınmış okutmaları push eder. Devam durumunu geriye dönük olarak güncellemeniz gerekebilir (örn. "yok" görünen bir kullanıcıyı "var" olarak işaretlemek).
S: Bir kullanıcının birden fazla cihazı olduğunda GİRİŞ/ÇIKIŞ'ı nasıl belirlerim?
Bir kullanıcının tüm okutmalarını tüm cihazlar genelinde
Bir kullanıcının tüm okutmalarını tüm cihazlar genelinde
LogTime ile sıralayın, ardından iş mantığınızı uygulayın. Kullanıcı farklı cihazlarda okutma yapıyorsa, tek bir cihazdan gelen Type alanına (CheckIn/CheckOut) yalnızca güvenmeyin.S: OperationID nedir ve nasıl kullanmalıyım?
Her işlem için benzersiz bir string tanımlayıcıdır. Gelen callback'lerde Biometric Gateway tarafından üretilir. Giden RESTful isteklerinde her istek için benzersiz bir tane (UUID veya zaman damgası tabanlı) üretmelisiniz. Yanıt bunu geri döndürür; böylece istek/yanıt çiftlerini ilişkilendirebilirsiniz.
Her işlem için benzersiz bir string tanımlayıcıdır. Gelen callback'lerde Biometric Gateway tarafından üretilir. Giden RESTful isteklerinde her istek için benzersiz bir tane (UUID veya zaman damgası tabanlı) üretmelisiniz. Yanıt bunu geri döndürür; böylece istek/yanıt çiftlerini ilişkilendirebilirsiniz.
S: Biyometrik şablonlar nasıl saklanır ve iletilir?
Biyometrik veri (parmak izi, yüz, avuç içi, kullanıcı fotoğrafı), Template nesnesinin
Biyometrik veri (parmak izi, yüz, avuç içi, kullanıcı fotoğrafı), Template nesnesinin
Data alanında Base64 kodludur. Parmak izi ve yüz şablonları ayrıca Size (bayt uzunluğu) ve Index (yuva numarası) içerir. Kart numaraları ve PIN'ler düz string'dir.Fiyatlandırma ve Lisanslama
S: API nasıl lisanslanır?
Biyometrik cihaz başına. İlk yıl API Aktivasyonu + Yıllık Lisans gerekir. Sonraki yıllarda yalnızca yıllık lisans yenilemesi gerekir. Fiyatlandırma için API Maliyeti'ne bakın.
Biyometrik cihaz başına. İlk yıl API Aktivasyonu + Yıllık Lisans gerekir. Sonraki yıllarda yalnızca yıllık lisans yenilemesi gerekir. Fiyatlandırma için API Maliyeti'ne bakın.
S: API lisansım sona ererse ne olur?
Lisans yenilenene kadar o cihaz için API iletişimi durur. Mevcut verileriniz etkilenmez, ancak yeni callback'ler veya RESTful komutlar işlenmez.
Lisans yenilenene kadar o cihaz için API iletişimi durur. Mevcut verileriniz etkilenmez, ancak yeni callback'ler veya RESTful komutlar işlenmez.
S: Şirket içi (on-premise) bir seçenek var mı?
Evet. Protocol Engine Lite, yalnızca LAN veya kendi barındırdığınız ortamlar için kendi sunucunuza (Windows/Linux) kurulabilir. Ayrıntılar için sales@camsbiometrics.com adresiyle iletişime geçin.
Evet. Protocol Engine Lite, yalnızca LAN veya kendi barındırdığınız ortamlar için kendi sunucunuza (Windows/Linux) kurulabilir. Ayrıntılar için sales@camsbiometrics.com adresiyle iletişime geçin.
Ek Bilgiler
Biyometrik Devam SDK'sı
Cams geleneksel bir SDK sunmaz. Tüm işlemler standart HTTP Callback ve RESTful API'leri kullanır — kütüphane kurulumu gerekmez.
SDK gerekmez. İletişim tamamen Cams Protocol Engine üzerinden, Callback URL'leri ve RESTful HTTP uç noktalarıyla yürütülür.
Bu, herhangi bir web platformuyla entegrasyonu kolaylaştırır:
OpenERPERPNextZoho PeopleSAPTallyHRAPPOdooÖzel Web Uygulamaları
Ek Bilgiler
API Maliyeti
API lisansları biyometrik cihaz başına faturalandırılır. İlk yıl = aktivasyon + lisans; sonraki yıllar = yalnızca lisans yenileme.
| Hizmet | USD | Notlar |
|---|---|---|
| Native Push — Cams ve Doğrulanmış Cihazlar | ||
| API Aktivasyonu | $120 | Cihaz başına bir kez. |
| Yıllık API Lisansı | $60 – $120 | Yıllık yenileme gereklidir. |
| Protokol Güncellemesi (Cams olmayan) | $120 – $280 | Tek seferlik. Cams olmayan cihazlarda Cams protokolünü etkinleştirir. |
| Hybrid Push — ZKTeco, eSSL ve Tüm Üçüncü Taraf Markalar | ||
| API Aktivasyonu | $150 | Cihaz başına bir kez. |
| Yıllık API Lisansı | $90 – $150 | Yıllık yenileme gereklidir. |
| Hybrid Connector (doğrulanmamış) | $150 – $300 | Tek seferlik. Hybrid Push kullanan doğrulanmamış cihazlar için gereklidir. |
| Donanım ve Diğer | ||
| Donanım | $220 – $720 | Modele göre değişir. |
Protocol Engine Lite (şirket içi) — Yalnızca LAN veya kendi barındırdığınız ortamlar için. Maliyet: $500–$10,000. Ayrıntılar için satışla iletişime geçin.