Webhooks ile Polling Karşılaştırması: Biyometrik Veriler Sunucunuza Gerçek Zamanlı Nasıl Ulaşmalı
Her biyometrik entegrasyonun tek bir temel soruya yanıt araması gerekir: Kapıdaki bir tarama, sisteminizdeki bir kayda nasıl dönüşür? Bunun iki yolu vardır. Sunucunuz cihaza sürekli olarak yeni bir şey olup olmadığını sorabilir; bu polling yöntemidir. Ya da sistem, bir şey olduğu anda sunucunuza haber verebilir; bu da webhook'tur. Biyometrik devam ve erişim verileri için webhook ile polling arasındaki seçim, verilerinizin ne kadar güncel olduğunu, cihazlar ve ağlar üzerindeki yükü ve kayıtlarınızın ne kadar güvenilir olduğunu etkiler. Bu kılavuz her iki yaklaşımı da sade bir dille açıklar, biyometrik veriler için neden webhook'un daha iyi varsayılan seçenek olduğunu gösterir, güvenilir bir webhook alıcısının nasıl oluşturulacağını ele alır ve polling'in hâlâ nerede yer bulduğunu anlatır.
01 · Pull ve Push
Verinin Hareket Edebileceği İki Yol
Önemli bir kargoyu beklediğinizi düşünün. Gelip gelmediğini kontrol etmek için her beş dakikada bir ön kapıya yürüyebilirsiniz. Ya da kapı zilinin çalmasını bekleyebilirsiniz. Her iki durumda da kargoya kavuşursunuz. Birinci yöntem çok fazla boşa yürüyüşe neden olur ve yine de beş dakikaya kadar geç kalmanıza yol açar. İkincisi ise kargo geldiği anda size haber verir.
Aradaki fark polling ile webhook arasındaki farktır.
Polling: sunucunuz sormaya devam eder
|
Sunucunuz Sorar: Son sorgulamadan bu yana yeni tarama var mı? |
→ |
Cihaz veya sistem Yanıtlar: Yeni bir şey yok |
→ |
Bekle Polling aralığı kadar bekle |
→ |
Tekrarla Gün boyunca tekrar tekrar sor |
Webhook: sistem sunucunuza haber verir
|
Çalışan tarama yapar Doğrulanmış bir parmak izi, yüz veya kart taraması |
→ |
Gateway Olayı hemen webhook URL'nize gönderir |
→ |
Sunucunuz Olayı alır ve tamamlandı yanıtı verir |
→ |
Tamamlandı Bekleme yok, boşa giden istek yok |
| Polling | Webhook'lar | |
|---|---|---|
| Konuşmayı kim başlatır | Sunucunuz | Veriye sahip sistem |
| Veri ne zaman ulaşır | Bir sonraki sorguda, en fazla tam bir aralık kadar geç | Taramadan hemen sonra |
| Hiçbir şey olmadığında yapılan istekler | Sürekli, çoğu boş | Yok |
| Cihazlar ve ağ üzerindeki yük | Hareketliliğe bakılmaksızın sürekli | Yalnızca iletilecek bir şey olduğunda |
| Sizin için karmaşıklık | Zaten alınanların takibini yapmak | Olayları almak ve onaylamak |
02 · Gizli Maliyetler
Polling Biyometrik Verilerde Neden Zorlanır
Polling, yavaş değişen veriler için ya da gecikmenin önemli olmadığı durumlarda işe yarar. Biyometrik devam ve erişim verileri ise tam tersidir. Vardiya başlangıcı ve bitişinde ani patlamalar hâlinde üretilir, geri kalan çoğu zaman sessizdir ve genellikle hemen ihtiyaç duyulur.
Gecikme baştan gelir
Polling'de en kötü durumdaki gecikme her zaman polling aralığınıza eşittir. Bir sorgudan bir saniye sonra gerçekleşen bir tarama, sunucunuzun bunu görmeden önce tüm aralığı beklemek zorundadır.
| Polling aralığı | Sisteminizin bilmeden önceki en kötü gecikme | Yeterli olduğu durumlar |
|---|---|---|
| Her 24 saatte bir | En fazla tam bir gün | Yalnızca aylık bordro |
| Saatte bir | En fazla 60 dakika | Günlük raporlar |
| Her 5 dakikada bir | En fazla 5 dakika | Çoğu gösterge paneli, uyarılar için değil |
| Her dakika | En fazla 60 saniye | Gerçek zamana yakın, yüksek istek maliyetiyle |
| Webhook | Polling gecikmesi yok | Canlı gösterge panelleri, bildirimler ve otomasyonlar |
İsteklerin çoğu boşa gider
Gerçek zamana yaklaşmak için daha sık polling yaparsınız. Ancak bu isteklerin çoğu hiçbir şey döndürmez. Bir cihazı her dakika sorgulamak, cihaz başına günde 1.440 istek anlamına gelir. 50 cihazda bu, günde 72.000 istek demektir ve bunların çoğu cevabı “yeni bir şey yok” olan bir soru sorar. Bu isteklerin her biri ağ kapasitesi ve cihaz işlem süresi harcar.
Takip etmek kırılganlaşır
Polling entegrasyonu, daha önce neyi çektiğini hatırlamak zorundadır; bunu genellikle gördüğü son kaydın zamanını ya da konumunu saklayarak yapar. Bu işaretçi yanlışsa, bir yeniden başlatma, sunucu ile cihaz arasındaki saat farkı ya da bir cihaz çevrimdışıyken depolanan kayıtlar nedeniyle, entegrasyon ya taramaları kaçırır ya da bunları iki kez içe aktarır. Bu sorunlar sessizdir ve genellikle yalnızca bir bordro uyuşmazlığı sırasında ortaya çıkar.
Her sitede zorlaşır
Tek bir cihazla polling yönetilebilir. Ancak birden fazla site ve markada onlarca cihaz olduğunda, her birinin kendi bağlantısı, kendi aralığı ve kendi son alınan işaretçisi varsa, polling kendi başına bir zamanlama ve izleme işine dönüşür.
|
Polling, birkaç önemli anı yakalamak için aynı soruyu günde binlerce kez sorar. Webhook'lar ise yalnızca gerçekten bir şey olduğunda konuşur. |
03 · Cams ile Push İletimi
Biyometrik Webhook'lar Nasıl Çalışır
Cams Biometrics Gateway ile webhook iletimi Callback API olarak adlandırılır. Gateway'e sunucunuzdaki bir URL verirsiniz ve doğrulanmış her tarama gerçekleştiği anda bu URL'ye gönderilir. Callback olayları, Native Push üzerindeki cihazlar için sıfır gecikmeyle iletilir.
Sunucunuzun aldığı veriler
|
Callback API, Gateway tarafından webhook URL'nize gönderilen istek {
"RealTime": {
"OperationID": "9nu1wak5616p",
"LabelName": "Burj Khalifa",
"SerialNumber": "ZHM11xxxxxxxx",
"PunchLog": {
"Type": "CheckOut",
"Temperature": "36.8",
"FaceMask": false,
"InputType": "Fingerprint",
"UserId": "2",
"LogTime": "2020-09-17 07:48:22 GMT +0530"
},
"AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
"Time": "2020-09-17 04:19:03 GMT +0000"
}
}
|
| Alan | Sunucunuza ne bildirir |
|---|---|
| OperationID | Bu olay için benzersiz bir referans |
| LabelName | Cihazın atandığı sitenin veya kapının adı |
| SerialNumber | Taramayı kaydeden belirli cihaz |
| Type | Giriş mi çıkış mı olduğu |
| InputType | Kişinin nasıl doğrulandığı: parmak izi, yüz, kart, PIN vb. |
| UserId | Taramayı yapan kişi; İK sistemindeki kimlikle eşleşir |
| LogTime | Taramanın cihazda gerçekleştiği zaman, saat dilimi farkıyla birlikte |
| AuthToken | İsteğin gerçek olduğunu doğrulamak için sunucunuzun kullandığı token |
| Time | Mesajın kendi zaman damgası, GMT cinsinden |
Sunucunuzun geri göndermesi gerekenler
Sunucunuz olayı aldıktan sonra kısa bir onay yanıtı döndürür. Bu, Gateway'e olayın güvenle ulaştığını bildirir.
|
Callback API, webhook'unuzun döndürmesi gereken yanıt { "status": "done" }
|
|
Cihaz yapamadığında bile push Her cihaz kendi başına veri gönderemez. Bazı eski veya doğrulanmamış cihazlar devam verilerini yalnızca yerel bir veritabanında veya dosyada saklar. Cams Hybrid Push ile Gateway, bu veritabanından okuyabilir (DB Pull) ya da o dosyayı izleyebilir (File Processing) ve yeni devam kayıtlarını yine de Callback URL'nize iletebilir. Altındaki cihaz normalde polling gerektirse bile sunucunuz her durumda push iletimi alır. |
04 · En İyi Uygulamalar
Güvenilir Bir Webhook Alıcısı Oluşturmak
Bir webhook alıcısını oluşturmak basittir; ancak birkaç uygulama, yalnızca testte çalışan bir alıcı ile yıllarca her gün çalışan bir alıcı arasındaki farkı yaratır.
| Uygulama | Ne yapılmalı | Neden önemli |
|---|---|---|
| Önce onaylayın | Olay alınır alınmaz done durumuyla yanıt verin, ardından daha yavaş işleri yapın | Sonraki sistemleriniz yavaş olsa bile Gateway'in isteğini kısa tutar |
| İşi kuyruğa alın | Alınan her olayı bir kuyruğa veya tabloya koyun ve ayrı olarak işleyin | Vardiya başındaki yoğunlukları olayları kaybetmeden karşılar |
| AuthToken'ı doğrulayın | Veriye güvenmeden önce her istekteki token'ı kontrol edin | Başkalarının URL'nize sahte devam verisi göndermesini engeller |
| HTTPS kullanın | Webhook'unuzu yalnızca HTTPS üzerinden açın; Gateway'den isteğe bağlı AES-256 şifreleme ile | Devam verileri kişisel veridir ve aktarım sırasında korunmalıdır |
| İdempotent hale getirin | Daha önce işlediğiniz olayları tespit edip yok saymak için OperationID kullanın | Tekrarlanan bir iletim asla çift devam kaydına dönüşmez |
| Devam için LogTime'a güvenin | Devamı, sunucunuzun olayı aldığı zamana göre değil, LogTime kullanarak kaydedin | Kesinti sırasında depolanan olaylar daha geç ulaşır ancak gerçek tarama zamanlarını korur |
| LogTime'a göre sıralayın | Saatleri hesaplamadan önce olayları LogTime'a göre sıralayın | Tamponlanmış olaylar bağlantı kesintisinden sonra sırasız ulaşabilir |
| Her şeyi kaydedin | Alınan her olayın ve gönderilen her yanıtın kaydını tutun | Sorun giderme ve denetimleri kolaylaştırır |
|
Ortalamalara değil, yoğunluklara göre planlayın 300 çalışanı olan bir site, gün büyük bölümünde neredeyse hiç veri almayabilir, ardından vardiya değişiminde 10 dakika içinde 300 olay alabilir. Alıcınızı bu zirve yük için tasarlayın. Hızlıca onaylamak ve işi kuyruğa almak, bununla başa çıkmanın en basit yoludur. |
Webhook nerede barınabilir
Webhook'unuzun, Gateway'in erişebileceği herkese açık bir HTTPS adresine ihtiyacı vardır. Bu, kendi uygulamanızdaki bir uç nokta, küçük bir bulut fonksiyonu ya da n8n veya Make gibi bir otomasyon aracındaki gelen webhook olabilir. Cihazlarınızın kendisinin herkese açık bir IP adresine ihtiyacı yoktur. Güvenlik duvarlarının arkasındaki siteler, dışa yönelik bir bağlantı üzerinden çalışan Hybrid Connector aracılığıyla Gateway'e bağlanabilir.
|
Bundan sonra ne olacağına sisteminiz karar verir Gateway doğrulanmış olayları iletir ve onayınızı bekler. Bundan sonra olanlar, örneğin İK sisteminize yazma, bir gösterge panelini güncelleme, geç kalma bildirimi gönderme ya da bir iş akışı başlatma, kendi yazılımınız ve kurallarınız tarafından belirlenir. |
05 · İkisini Birlikte Kullanmak
Polling'in Hâlâ Yer Bulduğu Alanlar
Canlı biyometrik veriler için varsayılan seçenek webhook'lar olmalıdır. Ancak isteğe bağlı veri çekme, yine de yararlı ve belirli görevleri olan bir yöntemdir. En güçlü entegrasyonlar, gerçek zamanlı iletim için webhook'ları, kontrol ve kurtarma için ise ara sıra isteğe bağlı veri çekmeyi kullanır.
| Durum | En uygun yaklaşım | Neden |
|---|---|---|
| Canlı devam, gösterge panelleri, bildirimler | Webhook'lar (Callback API) | Veri, tarama gerçekleştiği anda ulaşır |
| Sunucunuz bir süre çevrimdışı kaldı | Kayıtları isteğe bağlı çekin | Herhangi bir boşluğu doldurun ve hiçbir şeyin kaçırılmadığını doğrulayın |
| Gece veya haftalık mutabakat | Kayıtları bir takvime göre çekin | Webhook'ların ilettikleriyle bir güvenlik ağı olarak karşılaştırın |
| Yeni bir entegrasyon kurmak | Geçmiş kayıtları bir kez çekin | Webhook'lar devralmadan önce mevcut geçmişi içe aktarın |
| Belirli bir dönemi denetlemek | O dönemin kayıtlarını çekin | İnceleme için eksiksiz bir kayıt oluşturun |
Bu görevler için Cams RESTful API, cihazlardan kayıt yüklemek üzere işlemler içerir. Ara sıra ve bilinçli olarak kullanıldığında, kayıt çekme webhook'lara rakip olmak yerine onları tamamlar. Aradaki fark amaçtadır: Bir nedeniniz olduğunda çekersiniz, her dakika sadece ihtimal için sormak yerine.
Sıkça Sorulan Sorular
|
Biyometrik veriler için polling hiç webhook'lardan daha iyi olabilir mi? Sisteminiz herkese açık hiçbir uç nokta açamıyorsa ya da tek seferlik geçmiş içe aktarmalar için polling daha basit olabilir. Sürekli devam ve erişim verileri için webhook'lar daha hızlı, cihazlar ve ağlar üzerinde daha hafif ve birden fazla site genelinde ölçeklemesi daha kolaydır. |
|
Webhook sunucum kapalıysa taramalara ne olur? Webhook sunucunuz kapalıysa devam verileri Cams kuyruğunda saklanır. Sunucunuz yeniden çevrimiçi olduğunda, kuyruktaki kayıtlar otomatik olarak sunucunuza gönderilir. Kuyruk her 3 saatte bir otomatik olarak yeniden başlatılır ve Cams Portal üzerinden istediğiniz zaman elle de yeniden başlatabilirsiniz. Bu, geçici sunucu kesintileri nedeniyle devam kayıtlarının kaybolmamasını sağlar. |
|
Webhook'ların çalışması için biyometrik cihazlarımın herkese açık bir IP'ye ihtiyacı var mı? Hayır. Webhook URL'nize Gateway'in erişebilmesi gerekir, ancak cihazlarınızın erişebilmesi gerekmez. Herkese açık IP'si olmayan siteler, dışa yönelik bir bağlantı kullanan Hybrid Connector üzerinden bağlanabilir. |
|
n8n, Make veya Zapier'de webhook alabilir miyim? Evet. Gelen bir webhook alabilen her araç Cams Callback olaylarını alabilir. n8n ve Make, gerekli done onayını doğrudan da döndürebilir. Zapier ise bu yanıtı göndermek için önüne küçük bir aktarıcı yerleştirmeyi gerektirebilir. |
|
Veri yükünde LogTime ile Time neden farklı? LogTime, kişinin gerçekte taramayı yaptığı zamandır ve cihazın saat dilimi farkıyla kaydedilir. Time ise mesajın kendi zaman damgasıdır ve GMT cinsindendir. Cihaz çevrimdışıysa, mesaj taramadan çok sonra gönderilebilir. Devam için her zaman LogTime kullanın. |
Sonuç: Kapı Zilinin Çalmasına İzin Verin
Polling, biyometrik cihazlar yalnızca istek üzerine okunabildiğinde ve kimse devam verilerinin canlı olmasını beklemediğinde mantıklıydı. Bugün İK gösterge panelleri, bordro sistemleri, otomasyon araçları ve yapay zekâ asistanları, veriyi var olduğu anda aldıklarında en iyi şekilde çalışır. Bir cihaza günde binlerce kez aynı soruyu sormak, oraya ulaşmanın yavaş ve israfa dayalı bir yoludur.
Webhook'lar, doğrulanmış her taramayı sistemlerinizin hemen aldığı bir olaya dönüştürür; boşa giden istek yok, daha önce neyin çekildiğinin kırılgan takibi yok. İsteğe bağlı kayıt çekmeyi en iyi yaptığı işe, yani boşlukları doldurmaya ve eksiksizliği kontrol etmeye saklayın; geri kalan her şeyi webhook'lara bırakın.
Cams Biometrics Gateway, push iletimi etrafında tasarlanmıştır. Callback API, 15'ten fazla markadaki cihazlardan doğrulanmış her taramayı gerçek zamanlı olarak, tek ve tutarlı bir JSON formatında webhook'unuza gönderir. Hybrid Push modları, kendi başlarına push gönderemeyen cihazlardan bile push olaylarını iletir ve RESTful API, mutabakat için kayıt yükleme gibi isteğe bağlı işlemler sunar. Tüm iletişim, auth token doğrulaması ve isteğe bağlı AES-256 şifrelemesi ile HTTP/HTTPS üzerinden gerçekleşir. Platformu CamsBiometrics.com adresinde keşfedin ve Callback API dokümantasyonunun tamamını developer.camsbiometrics.com adresinde okuyun.