Support Hub/API & Integrations/Native Push ve Hybrid Push Modları: Teknik Karar Ağacı
Translated from the English article and reviewed by a person. Read the English original
Developer

Native Push ve Hybrid Push Modları: Teknik Karar Ağacı

Native Push ve Hybrid Push Modları: Teknik Karar Ağacı

Cams Biometric Gateway'e bağlanan her biyometrik cihaz, iki push modundan biri üzerinden bağlanır. Cihazınızın kullandığı mod, hangi API'lerin kullanılabilir olduğunu, olayların nasıl iletildiğini ve altyapınızın nasıl yapılandırılması gerektiğini belirler. Bu kılavuz, karardaki her değişkeni cihaz türünden iletişim yöntemine ve dağıtım topolojisine kadar adım adım ele alır, böylece oluşturmaya başlamadan önce doğru yolu seçebilirsiniz.

İlk Soru: Hangi Tür Cihazı Bağlıyorsunuz?

İletişim yöntemini veya dağıtım topolojisini seçmeden önce yanıtlanması gereken daha temel bir soru vardır: cihazınız bir Cams Biometrics cihazı mı, yoksa Cams geliştirici portalında doğrulanmış bir cihaz mı?

Bu sorunun yanıtı push modunuzu tamamen belirler. Yanıt evetse Native Push kullanırsınız ve başka bir karar gerekmez. Yanıt hayırsa Hybrid Push kapsamındasınız ve bir dizi ek karar sizi bekliyor.

Mod 1
Native Push
Tüm Cams Biometrics makineleri ve developer.camsbiometrics.com adresinde doğrulanmış olarak listelenen tüm cihazlar için. Cihaz, internet üzerinden doğrudan Biometric Gateway ile iletişim kurar ve ek bir kurulum gerektirmez.

Tüm 38 işlem
Tam Callback API
Tam RESTful API

Mod 2
Hybrid Push
Doğrulanmamış diğer tüm cihazlar için. Ortamınıza uygun bir iletişim yöntemi ve dağıtım topolojisi seçersiniz. API kullanılabilirliği, seçtiğiniz kombinasyona bağlıdır.

3 iletişim yöntemi
2 topoloji seçeneği
Değişken API erişimi

Native Push: tam tablo

Native Push cihazları, cihazı internete bağlamak dışında herhangi bir yapılandırma gerektirmeden Gateway'in 38 işleminin tamamına tam erişim elde eder. Callback API olayları gecikmesiz iletir. RESTful API komutları yaklaşık 15 saniyede yürütülür. SDK, yerel yazılım veya topoloji kararı gerekmez.

Hybrid Push'u Anlamak: Üç İletişim Yöntemi

Cihazınız bir Cams veya doğrulanmış cihaz değilse, sonraki karar Gateway'in donanımınızla fiilen nasıl iletişim kuracağıdır. Kullanılabilir üç iletişim yöntemi vardır ve her birinin farklı gereksinimleri ve hangi API özelliklerini kullanabileceğiniz konusunda farklı sonuçları vardır.

İletişim yöntemi ağ yapılandırmanızla ilgili değildir. Gateway'in belirli cihazınızdan veri okumak ve cihaza komut göndermek için kullandığı teknik mekanizmayla ilgilidir. Bu seçim, donanımınızın desteklediği özelliklerle sınırlıdır.

a
Device SDK
Tam API erişimi için en iyi seçenek
Gateway, donanımla cihaz üreticisinin SDK'sı üzerinden iletişim kurar. SDK, düşük seviyeli cihaz protokolünü yönetir ve Gateway, SDK'nın desteklediği tüm özellikleri API'si üzerinden sunar. Hybrid Push'taki RESTful API işlemlerini etkinleştiren tek iletişim yöntemi budur.
Tam Callback API + Tam RESTful API (SDK yetenekleri dahilinde)
b
DB Pull
Yalnızca devam verileri
Gateway, cihazın kendi yönetim yazılımının devam kayıtlarını yazdığı yerel bir veritabanından okur. Gateway bu veritabanını izler ve yeni kayıtları gerçek zamanlı olarak callback URL'nize iletir. Cihazla doğrudan iletişim kurulmaz, bu nedenle cihaza komut gönderilemez. Kullanıcı ekleme, kayıt silme veya günlük yükleme gibi işlemler kullanılamaz.
Callback API: yalnızca devam ve giriş-çıkış kayıtları. RESTful API: desteklenmiyor.
c
File Processing
Yalnızca devam verileri
Yerel bilgisayardaki belirlenmiş devam dosyası sürekli izlenir. Cihaz yazılımı bu dosyayı yeni devam kayıtlarıyla her güncellediğinde Gateway değişikliği algılar, yeni kayıtları çıkarır ve bunları gerçek zamanlı olarak callback URL'nize iletir. DB Pull gibi, bu yöntem cihaz açısından salt okunurdur ve aynı API sınırlamalarını taşır.
Callback API: yalnızca devam ve giriş-çıkış kayıtları. RESTful API: desteklenmiyor.
İletişim yöntemi nasıl seçilir

Cihazınızın Cams Gateway tarafından desteklenen bir üretici SDK'sı varsa Device SDK (a) seçin. Hybrid Push cihazları için RESTful API işlemlerini etkinleştiren tek yöntem budur. SDK desteklenmiyorsa veya kullanılamıyorsa, DB Pull (b) veya File Processing (c) yine de devam verilerini gerçek zamanlı olarak callback endpoint'inize iletir ve bu, birçok kullanım senaryosu için yeterlidir.

Hybrid Push'u Anlamak: İki Dağıtım Topolojisi

Bir iletişim yöntemi seçtikten sonra ikinci karar, Gateway'in cihazınıza, veritabanınıza veya dosyanıza nereden bağlanacağıdır. Bu topoloji kararıdır ve cihazın fiziksel konumundaki ağ ortamınıza bağlıdır.

Topoloji X

Doğrudan
Cihazın bağlı olduğu veya cihaz yönetim yazılımının çalıştığı saha bilgisayarının genel bir IP adresi vardır ve yerel ağa port yönlendirmesi yapılandırılmıştır. Biometric Gateway, internet üzerinden doğrudan cihaza, veritabanına veya dosyalara bağlanır.
Gerekli: sahada genel IP + port yönlendirme
Topoloji Y

Dolaylı
Yerel saha bilgisayarına bir Hybrid Connector uygulaması yüklenir. Bu uygulama, yerel makine ile Biometric Gateway arasında giden bir köprü görevi görür ve bağlantıyı içeriden kurar; dışarıdan gelen bir bağlantı gerektirmez. Müşteri tarafında genel IP gerekmez.
Gerekli: yerel bilgisayara Hybrid Connector kurulumu. Genel IP gerekmez.
Topoloji önerisi

Sahada genel IP veya port yönlendirmesi yapılandıramıyorsanız, Hybrid Connector ile Dolaylı topolojiyi (Y) seçin. Bu, en basit dağıtım yoludur ve müşteri tarafında ağ yapılandırması gerektirmez. Genel IP mevcut ve yapılandırılmışsa, Doğrudan topoloji (X) da çalışır ve sahada ek yazılım kurulumu gerektirmez.

Karar Ağacı: Hangi Modu Seçmelisiniz?

Bu karar ağacını yukarıdan aşağıya doğru izleyin. Durumunuza uyan ilk yanıtta durun.

Karar ağacı, en üstten başlayın
1. Cihazınız bir Cams Biometrics cihazı mı, yoksa developer.camsbiometrics.com adresinde doğrulanmış olarak mı listeleniyor?
Evet Native Push kullanın. Tam API erişimi. Başka karar gerekmez.
Hayır 2. soruya devam edin.
2. Cams Gateway, cihaz üreticiniz için SDK'yı destekliyor mu?
Evet Hybrid Push, Device SDK (a) kullanın. SDK sınırları dahilinde tam Callback ve RESTful API erişimi. Topoloji için 3. soruya devam edin.
Hayır 2b. soruya devam edin.
2b. Cihaz yönetim yazılımınız devam kayıtlarını yerel bir veritabanına yazıyor mu?
Evet Hybrid Push, DB Pull (b) kullanın. Yalnızca devam Callback. Topoloji için 3. soruya devam edin.
3. Saha bilgisayarının, kullanılabilir port yönlendirmesiyle birlikte genel bir IP adresi var mı?
Evet Doğrudan topoloji (X) kullanın. Sahada ek yazılım gerekmez.
Hayır Dolaylı topoloji (Y) kullanın. Hybrid Connector'ı yerel saha bilgisayarına kurun.

Hybrid Push Özellik Kullanılabilirlik Matrisi

Aşağıdaki tablo, iletişim yöntemi ve dağıtım topolojisinin tüm kombinasyonlarını ve her durumda hangi API özelliklerinin kullanılabilir olduğunu gösterir. Seçtiğiniz yapılandırmanın neleri desteklediğini doğrulamak için bunu karar ağacıyla birlikte kullanın.

Mod İletişim Topoloji Callback API RESTful API
Doğrudan Cihaz (a) Device SDK (X) Genel IP Tam Tam (SDK sınırları geçerlidir)
Dolaylı Cihaz (a) Device SDK (Y) Hybrid Connector Tam Tam (SDK sınırları geçerlidir)
Doğrudan DB (b) DB Pull (X) Genel IP Yalnızca devam Desteklenmiyor
Dolaylı DB (b) DB Pull (Y) Hybrid Connector Yalnızca devam Desteklenmiyor
Doğrudan Dosya (c) File Processing (X) Genel IP Yalnızca devam Desteklenmiyor
Dolaylı Dosya (c) File Processing (Y) Hybrid Connector Yalnızca devam Desteklenmiyor
Önemli donanım uyarısı

Donanım sınırlamaları, Device SDK modunda bile API özelliklerini daha da kısıtlayabilir. Cihaz modelinin firmware sürümüne veya üretici SDK'sının sunduğu yeteneklere bağlı olarak belirli API'ler çalışmayabilir. Yukarıdaki matris, Gateway mimarisinin neleri desteklediğini gösterir; her bir cihaz modelinin neleri desteklediğini garanti etmez. Üretime almadan önce her zaman kendi donanımınızla test edin ve sınır durumları Cams destek ekibiyle doğrulayın.

Topoloji Kararının Etkileyip Etkilemediği

Sık karıştırılan bir nokta, topoloji ile API kullanılabilirliği arasındaki ilişkidir. Doğrudan veya Dolaylı topoloji seçimi, hangi API özelliklerinin kullanılabilir olduğunu etkilemez. API özellik seti tamamen iletişim yöntemi tarafından belirlenir.

Topolojinin etkilediği şey, Gateway ile yerel ortamınız arasındaki ağ bağlantısının nasıl kurulduğudur. Doğrudan topoloji, sahada genel IP ve port yönlendirmesi gerektirir. Dolaylı topoloji ise Hybrid Connector'ın yerel makineye kurulmasını gerektirir. Doğrudan Device SDK ile Dolaylı Device SDK için ve Doğrudan DB Pull ile Dolaylı DB Pull için kullanılabilir API özellikleri aynıdır.

“İletişim yönteminizi, entegrasyonunuzun hangi API özelliklerine ihtiyaç duyduğuna göre seçin. Topolojinizi ise ağ ortamınızın neyi desteklediğine göre seçin. Bunlar birbirinden bağımsız kararlardır.”

Sık Sorulan Sorular

DB Pull veya File Processing'i RESTful API komutlarıyla birlikte kullanabilir miyim?
Hayır. DB Pull ve File Processing salt okunur entegrasyon yöntemleridir. Gateway'in cihazın kendi yazılımı tarafından üretilen devam verilerini gözlemlemesine izin verirler, ancak cihaza komut geri gönderilebilecek bir kanal oluşturmazlar. Kullanıcı ekleme, kayıt silme veya günlük yükleme gibi RESTful API işlemleri, çift yönlü bir iletişim kanalı oluşturan Device SDK modunu gerektirir.
Hybrid Connector, cihaz yazılımıyla aynı makineye kurulmak zorunda mı?
Evet. Hybrid Connector, cihazın bağlı olduğu veya cihaz yönetim yazılımının çalıştığı aynı yerel bilgisayara kurulmalıdır. Bunun nedeni, iletişim yönteminize bağlı olarak cihaza, yerel veritabanına veya devam dosyasına yerel erişim ihtiyacı duymasıdır. Connector daha sonra Gateway'e giden bir tünel oluşturur ve bu konumda genel IP ihtiyacını ortadan kaldırır.
Native Push ile Hybrid Push arasındaki gecikme farkı nedir?
Native Push için Callback API olayları gecikmesiz iletilir ve RESTful API komutları yaklaşık 30 saniyede yürütülür. Device SDK kullanan Hybrid Push için gecikme, SDK'nın kendi iletişim döngüsüne bağlıdır ve cihaz üreticisine göre değişir. DB Pull ve File Processing gecikmesi, yerel yazılımın yeni kayıtları ne sıklıkta yazdığına ve Gateway'in değişikliği ne kadar hızlı algıladığına bağlıdır; genellikle olayı cihaz kaydettikten sonra birkaç saniye içinde gerçekleşir.

Sonuç: Modunuzu Kısıtlarınıza Göre Seçin

Cams Biometric Gateway için bağlantı modu kararı bir tercih sorusu değil, bir kısıt sorusudur. Cihazınız uygunsa Native Push doğru yanıttır, çünkü en az yapılandırmayla en fazla yetenek sunar. Diğer tüm durumlar için Hybrid Push geçerlidir ve bunun içinde Device SDK modu, API erişimi açısından Native Push'a en yakın seçenektir.

Tam SDK erişimi mevcut değilse, DB Pull ve File Processing, sistemlerinize yine de gerçek zamanlı devam verileri ileten pratik yollardır. Topoloji kararı ise API'nin neler yapabileceğini değiştirmeyen, altyapı düzeyinde ayrı bir seçimdir.

Karar ağacıyla başlayın, seçiminizi özellik matrisine göre doğrulayın, donanımınızla test edin ve üretime geçmeden önce sınır durumlarını Cams destek ekibiyle doğrulayın.

Was this article helpful?