Support Hub/API & Integrations/Webhooks ile Polling Karşılaştırması: Biyometrik Veriler…
Translated from the English article and reviewed by a person. Read the English original
Developer

Webhooks ile Polling Karşılaştırması: Biyometrik Veriler Sunucunuza Gerçek Zamanlı Nasıl Ulaşmalı

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.

Was this article helpful?