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.