Support Hub/API & Integrations/Webhook vs Polling: Bagaimana Data Biometrik Real-Time…
Translated from the English article and reviewed by a person. Read the English original
Developer

Webhook vs Polling: Bagaimana Data Biometrik Real-Time Seharusnya Sampai ke Server Anda

Webhook vs Polling: Bagaimana Data Biometrik Real-Time Seharusnya Sampai ke Server Anda

Setiap integrasi biometrik harus menjawab satu pertanyaan mendasar: bagaimana pemindaian di pintu menjadi catatan di sistem Anda? Ada dua cara untuk melakukannya. Server Anda dapat terus menanyakan kepada perangkat apakah ada sesuatu yang baru terjadi, yaitu polling. Atau sistem dapat memberi tahu server Anda saat sesuatu terjadi, yaitu webhook. Untuk data absensi dan akses biometrik, pilihan antara webhook dan polling memengaruhi seberapa segar data Anda, seberapa besar beban yang Anda berikan pada perangkat dan jaringan, dan seberapa andal catatan Anda. Panduan ini menjelaskan kedua pendekatan dengan bahasa yang sederhana, menunjukkan mengapa webhook adalah pilihan default yang lebih baik untuk data biometrik, membahas cara membangun penerima webhook yang andal, dan menjelaskan di mana polling masih memiliki tempatnya.

01 · Pull vs Push

Dua Cara Data Dapat Berpindah

Bayangkan Anda sedang menunggu paket penting. Anda bisa berjalan ke pintu depan setiap lima menit untuk memeriksa apakah paket sudah tiba. Atau Anda bisa menunggu bel pintu berbunyi. Keduanya sama-sama membuat paket sampai ke tangan Anda. Yang pertama membuang banyak perjalanan dan tetap membuat Anda terlambat hingga lima menit. Yang kedua memberi tahu Anda saat paket tiba.

Itulah perbedaan antara polling dan webhook.

Polling: server Anda terus bertanya

Server Anda

Bertanya: adakah pemindaian baru sejak terakhir kali?

→

Perangkat atau sistem

Menjawab: tidak ada yang baru

→

Tunggu

Diam selama interval polling

→

Ulangi

Bertanya lagi dan lagi sepanjang hari

Webhook: sistem memberi tahu server Anda

Pemindaian karyawan

Pemindaian sidik jari, wajah, atau kartu yang terverifikasi

→

Gateway

Langsung mengirim event ke URL webhook Anda

→

Server Anda

Menerima event dan membalas done

→

Done

Tanpa menunggu dan tanpa permintaan yang terbuang

Polling Webhook
Siapa yang memulai percakapan Server Anda Sistem yang memiliki data
Kapan data tiba Pada polling berikutnya, terlambat hingga satu interval penuh Segera setelah pemindaian
Permintaan saat tidak ada kejadian Terus-menerus, sebagian besar kosong Tidak ada
Beban pada perangkat dan jaringan Konstan, tanpa memandang aktivitas Hanya saat ada yang perlu dikirim
Kompleksitas bagi Anda Melacak apa yang sudah diambil Menerima dan mengonfirmasi event

02 · Biaya Tersembunyi

Mengapa Polling Kesulitan dengan Data Biometrik

Polling cocok untuk data yang berubah lambat atau ketika penundaan tidak menjadi masalah. Data absensi dan akses biometrik justru sebaliknya. Data ini dihasilkan dalam ledakan singkat saat awal dan akhir shift, sepi sebagian besar waktu lainnya, dan sering kali dibutuhkan segera.

Penundaan sudah melekat

Dengan polling, penundaan terburuk selalu sama dengan interval polling Anda. Pemindaian yang terjadi satu detik setelah polling harus menunggu seluruh interval sebelum server Anda melihatnya.

Interval polling Penundaan terburuk sebelum sistem Anda mengetahui Cukup untuk
Setiap 24 jam Hingga satu hari penuh Hanya untuk penggajian bulanan
Setiap jam Hingga 60 menit Laporan harian
Setiap 5 menit Hingga 5 menit Sebagian besar dasbor, bukan peringatan
Setiap menit Hingga 60 detik Hampir real time, dengan biaya permintaan yang tinggi
Webhook Tanpa penundaan polling Dasbor langsung, notifikasi, dan otomasi

Sebagian besar permintaan terbuang percuma

Untuk mendekati real time, Anda perlu melakukan polling lebih sering. Namun, sebagian besar permintaan tersebut tidak menghasilkan apa-apa. Melakukan polling pada satu perangkat setiap menit berarti 1.440 permintaan per perangkat per hari. Untuk 50 perangkat, itu berarti 72.000 permintaan per hari, sebagian besar menanyakan hal yang jawabannya adalah “tidak ada yang baru.” Setiap permintaan tersebut menggunakan kapasitas jaringan dan waktu pemrosesan perangkat.

Pelacakan menjadi rapuh

Integrasi polling harus mengingat apa yang sudah diambil, biasanya dengan menyimpan waktu atau posisi catatan terakhir yang dilihatnya. Jika penanda tersebut salah, misalnya karena restart, perbedaan jam antara server dan perangkat, atau catatan yang tersimpan saat perangkat offline, integrasi akan melewatkan pemindaian atau mengimpornya dua kali. Masalah ini tidak terlihat dan sering baru muncul saat terjadi sengketa penggajian.

Semakin sulit dengan setiap lokasi

Dengan satu perangkat, polling masih mudah dikelola. Dengan puluhan perangkat di beberapa lokasi dan merek, masing-masing dengan koneksi, interval, dan penanda pengambilan terakhir sendiri, polling menjadi pekerjaan penjadwalan dan pemantauan tersendiri.

Polling menanyakan hal yang sama ribuan kali sehari untuk menangkap segelintir momen yang penting. Webhook hanya berbicara ketika sesuatu benar-benar terjadi.

03 · Pengiriman Push dengan Cams

Cara Kerja Webhook Biometrik

Dengan Cams Biometrics Gateway, pengiriman webhook disebut Callback API. Anda memberikan URL di server Anda kepada Gateway, dan setiap pemindaian yang terverifikasi akan dikirim ke URL tersebut saat terjadi. Event Callback dikirim tanpa latensi untuk perangkat pada Native Push.

Yang diterima server Anda

Callback API, permintaan yang dikirim ke URL webhook Anda oleh Gateway

{
  "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"
  }
}
Field Informasi yang disampaikan kepada server Anda
OperationID Referensi unik untuk event ini
LabelName Nama lokasi atau pintu tempat perangkat ditetapkan
SerialNumber Perangkat spesifik yang mencatat pemindaian
Type Apakah itu check-in atau check-out
InputType Cara verifikasi orang tersebut: sidik jari, wajah, kartu, PIN, dan sebagainya
UserId Siapa yang memindai, sesuai dengan ID di sistem HR Anda
LogTime Kapan pemindaian terjadi di perangkat, beserta offset zona waktunya
AuthToken Token yang digunakan server Anda untuk memastikan permintaan itu asli
Time Cap waktu pesan itu sendiri, dalam GMT

Yang harus dikirim kembali oleh server Anda

Setelah server Anda menerima event, server membalas dengan konfirmasi singkat. Ini memberi tahu Gateway bahwa event telah diterima dengan aman.

Callback API, respons yang harus dikembalikan webhook Anda

{ "status": "done" }

Push, meskipun perangkat tidak mampu

Tidak semua perangkat dapat mengirim data sendiri. Beberapa perangkat lama atau yang belum terverifikasi hanya menyimpan absensi di database lokal atau file. Dengan Cams Hybrid Push, Gateway dapat membaca dari database tersebut (DB Pull) atau memantau file tersebut (File Processing), dan tetap mengirimkan catatan absensi baru ke Callback URL Anda. Server Anda tetap menerima pengiriman push dalam kedua kasus, meskipun perangkat di baliknya biasanya perlu di-polling.

04 · Praktik Terbaik

Membangun Penerima Webhook yang Andal

Penerima webhook mudah dibangun, tetapi beberapa praktik membuat perbedaan antara penerima yang berfungsi saat pengujian dan yang berfungsi setiap hari selama bertahun-tahun.

Praktik Yang harus dilakukan Mengapa penting
Konfirmasi terlebih dahulu Balas dengan status done segera setelah event diterima, lalu lakukan pekerjaan yang lebih lambat setelahnya Menjaga permintaan Gateway’ tetap singkat, meskipun sistem hilir Anda lambat
Antrekan pekerjaan Masukkan setiap event yang diterima ke dalam antrean atau tabel, dan proses secara terpisah Menangani lonjakan saat awal shift tanpa kehilangan event
Validasi AuthToken Periksa token di setiap permintaan sebelum mempercayai data Mencegah pihak lain mengirim absensi palsu ke URL Anda
Gunakan HTTPS Tampilkan webhook Anda hanya melalui HTTPS, dengan enkripsi AES-256 opsional dari Gateway Data absensi adalah data pribadi dan harus dilindungi selama pengiriman
Pastikan idempoten Gunakan OperationID untuk mendeteksi dan mengabaikan event yang sudah diproses Pengiriman ulang tidak pernah menjadi catatan absensi ganda
Gunakan LogTime untuk absensi Catat absensi menggunakan LogTime, bukan waktu server menerima event Event yang tersimpan selama gangguan tiba terlambat tetapi tetap mempertahankan waktu pemindaian yang sebenarnya
Urutkan berdasarkan LogTime Urutkan event berdasarkan LogTime sebelum menghitung jam kerja Event yang di-buffer dapat tiba dalam urutan yang salah setelah koneksi terputus
Catat semuanya Simpan catatan setiap event yang diterima dan setiap respons yang dikirim Memudahkan pemecahan masalah dan audit

Rencanakan untuk lonjakan, bukan rata-rata

Lokasi dengan 300 karyawan mungkin hampir tidak menerima apa pun sepanjang hari, lalu 300 event dalam sepuluh menit saat pergantian shift. Rancang penerima Anda untuk puncak tersebut. Mengonfirmasi dengan cepat dan mengantrekan pekerjaan adalah cara termudah untuk menanganinya.

Di mana webhook dapat ditempatkan

Webhook Anda memerlukan alamat HTTPS publik yang dapat dijangkau oleh Gateway. Alamat tersebut dapat berupa endpoint di aplikasi Anda sendiri, fungsi cloud kecil, atau incoming webhook di alat otomasi seperti n8n atau Make. Perangkat Anda sendiri tidak memerlukan IP publik. Lokasi yang berada di balik firewall dapat terhubung ke Gateway melalui Hybrid Connector, yang bekerja melalui koneksi keluar.

Sistem Anda menentukan apa yang terjadi selanjutnya

Gateway mengirimkan event yang terverifikasi dan menunggu konfirmasi Anda. Apa yang terjadi setelahnya, seperti menulis ke HRMS Anda, memperbarui dasbor, mengirim pemberitahuan keterlambatan, atau memulai alur kerja, ditentukan oleh perangkat lunak dan aturan Anda sendiri.

05 · Menggunakan Keduanya Bersama

Di Mana Polling Masih Berguna

Webhook sebaiknya menjadi pilihan default untuk data biometrik langsung. Namun, pengambilan data sesuai permintaan tetap memiliki tugas tertentu yang berguna. Integrasi terbaik menggunakan webhook untuk pengiriman real-time dan pengambilan sesuai permintaan sesekali untuk pemeriksaan dan pemulihan.

Situasi Pendekatan terbaik Alasan
Absensi langsung, dasbor, notifikasi Webhook (Callback API) Data tiba saat pemindaian terjadi
Server Anda sempat offline dalam periode tertentu Ambil log sesuai permintaan Isi celah dan pastikan tidak ada yang terlewat
Rekonsiliasi harian atau mingguan Ambil log sesuai jadwal Bandingkan dengan yang dikirim webhook, sebagai jaring pengaman
Menyiapkan integrasi baru Ambil log historis sekali Impor riwayat yang ada sebelum webhook mengambil alih
Mengaudit periode tertentu Ambil log untuk periode tersebut Menghasilkan catatan lengkap untuk ditinjau

Untuk tugas-tugas ini, Cams RESTful API menyediakan operasi untuk memuat log dari perangkat. Jika digunakan sesekali dan dengan sengaja, pengambilan log melengkapi webhook dan bukan bersaing dengannya. Perbedaannya terletak pada tujuan: Anda mengambil log ketika ada alasan, bukan menanyakannya setiap menit untuk berjaga-jaga.

Pertanyaan yang Sering Diajukan

Apakah polling pernah lebih baik daripada webhook untuk data biometrik?

Polling bisa lebih sederhana ketika sistem Anda sama sekali tidak dapat menampilkan endpoint publik, atau untuk impor historis satu kali. Untuk data absensi dan akses yang berkelanjutan, webhook lebih cepat, lebih ringan bagi perangkat dan jaringan, serta lebih mudah diskalakan di berbagai lokasi.

Apa yang terjadi pada pemindaian jika server webhook saya mati?

Jika server webhook Anda mati, data absensi akan disimpan dalam antrean Cams. Setelah server Anda kembali online, catatan dalam antrean akan dikirim secara otomatis ke server Anda. Antrean akan dimulai ulang secara otomatis setiap 3 jam, dan Anda juga dapat memulai ulang secara manual kapan saja dari Cams Portal. Hal ini memastikan bahwa catatan absensi tidak hilang akibat gangguan server sementara.

Apakah perangkat biometrik saya memerlukan IP publik agar webhook berfungsi?

Tidak. URL webhook Anda harus dapat dijangkau oleh Gateway, tetapi perangkat Anda tidak perlu. Lokasi tanpa IP publik dapat terhubung melalui Hybrid Connector, yang menggunakan koneksi keluar.

Dapatkah saya menerima webhook di n8n, Make, atau Zapier?

Ya. Alat apa pun yang dapat menerima incoming webhook dapat menerima event Cams Callback. n8n dan Make juga dapat langsung mengembalikan konfirmasi done yang diperlukan. Zapier mungkin memerlukan relay kecil di depannya untuk mengirim balasan tersebut.

Mengapa LogTime dan Time berbeda dalam payload?

LogTime adalah waktu saat orang tersebut benar-benar memindai, dicatat dengan offset zona waktu perangkat. Time adalah cap waktu dari pesan itu sendiri, dalam GMT. Jika perangkat sedang offline, pesan dapat dikirim jauh setelah pemindaian. Selalu gunakan LogTime untuk absensi.

Kesimpulan: Biarkan Bel Pintu Berbunyi

Polling masuk akal ketika perangkat biometrik hanya dapat dibaca atas permintaan dan tidak ada yang mengharapkan data absensi bersifat langsung. Saat ini, dasbor HR, sistem penggajian, alat otomasi, dan asisten AI bekerja paling baik dengan data pada saat data itu tercipta. Menanyakan hal yang sama ribuan kali sehari kepada perangkat adalah cara yang lambat dan boros untuk mencapai hal itu.

Webhook mengubah setiap pemindaian yang terverifikasi menjadi event yang langsung diterima sistem Anda, tanpa permintaan yang terbuang dan tanpa pelacakan yang rapuh atas apa yang sudah diambil. Gunakan pengambilan log sesuai permintaan untuk hal yang paling cocok dilakukannya, yaitu mengisi celah dan memeriksa kelengkapan, dan biarkan webhook membawa semua hal lainnya.

Cams Biometrics Gateway dibangun dengan berfokus pada pengiriman push. Callback API-nya mengirim setiap pemindaian yang terverifikasi ke webhook Anda secara real time, dari perangkat di lebih dari 15 merek, dalam satu format JSON yang konsisten. Mode Hybrid Push mengirimkan event push bahkan dari perangkat yang tidak dapat mengirim push sendiri, dan RESTful API menyediakan operasi sesuai permintaan seperti memuat log untuk rekonsiliasi. Semua komunikasi berjalan melalui HTTP/HTTPS dengan validasi auth token dan enkripsi AES-256 opsional. Jelajahi platform di CamsBiometrics.com dan baca dokumentasi lengkap Callback API di developer.camsbiometrics.com.

Was this article helpful?