FAQ, SDK, dan biaya
Pertanyaan umum dari para integrator, serta cara kerja SDK dan harga API.
Informasi Tambahan
Pertanyaan yang Sering Diajukan
Pertanyaan umum tentang integrasi dengan Cams Biometrics Web API 3.0.
Umum
T: Apa itu Cams Biometric Gateway dan Biometric API-nya?
Cams Biometric Gateway adalah platform cloud universal yang menyediakan Biometric API sehingga aplikasi web apa pun dapat berkomunikasi dengan perangkat absensi dan kontrol akses biometrik secara real-time. Mendukung 38 operasi melalui API Callback (masuk) dan RESTful (keluar) — tanpa memerlukan SDK perangkat atau IP statis.
Cams Biometric Gateway adalah platform cloud universal yang menyediakan Biometric API sehingga aplikasi web apa pun dapat berkomunikasi dengan perangkat absensi dan kontrol akses biometrik secara real-time. Mendukung 38 operasi melalui API Callback (masuk) dan RESTful (keluar) — tanpa memerlukan SDK perangkat atau IP statis.
T: Apakah saya memerlukan SDK untuk integrasi?
Tidak. Cams tidak menyediakan maupun mewajibkan SDK. Semua komunikasi memakai permintaan HTTP/HTTPS POST standar dengan payload JSON. Bahasa apa pun yang dapat melakukan panggilan HTTP akan berfungsi.
Tidak. Cams tidak menyediakan maupun mewajibkan SDK. Semua komunikasi memakai permintaan HTTP/HTTPS POST standar dengan payload JSON. Bahasa apa pun yang dapat melakukan panggilan HTTP akan berfungsi.
T: Bahasa pemrograman apa yang didukung?
Bahasa apa pun yang dapat mengirim/menerima HTTP POST dengan JSON — PHP, Python, Java, C#, Node.js, Go, Ruby, dan lainnya. Kami menyediakan prompt pembuat kode AI untuk 7 bahasa.
Bahasa apa pun yang dapat mengirim/menerima HTTP POST dengan JSON — PHP, Python, Java, C#, Node.js, Go, Ruby, dan lainnya. Kami menyediakan prompt pembuat kode AI untuk 7 bahasa.
T: Apa itu Cams Protocol Engine?
Ini adalah middleware cloud yang berada di antara perangkat biometrik dan server Anda. Menangani penerjemahan protokol, normalisasi data, dan cache offline, serta menghadirkan API JSON yang konsisten apa pun merek atau model perangkat di baliknya.
Ini adalah middleware cloud yang berada di antara perangkat biometrik dan server Anda. Menangani penerjemahan protokol, normalisasi data, dan cache offline, serta menghadirkan API JSON yang konsisten apa pun merek atau model perangkat di baliknya.
T: Apa itu API Monitor?
API Monitor adalah portal admin Anda untuk mengonfigurasi Callback URL, mengelola AuthToken, mengatur Security Key, melihat status perangkat, serta mengakses URL endpoint RESTful dan Service Tag ID Anda.
API Monitor adalah portal admin Anda untuk mengonfigurasi Callback URL, mengelola AuthToken, mengatur Security Key, melihat status perangkat, serta mengakses URL endpoint RESTful dan Service Tag ID Anda.
Kompatibilitas Perangkat
T: Perangkat biometrik apa yang didukung?
Semua mesin Cams Biometrics (tercantum di camsbiometrics.com/product) mendukung API penuh dengan Native Push. Perangkat yang terverifikasi di developer.camsbiometrics.com juga memiliki dukungan Native Push penuh.
Semua mesin Cams Biometrics (tercantum di camsbiometrics.com/product) mendukung API penuh dengan Native Push. Perangkat yang terverifikasi di developer.camsbiometrics.com juga memiliki dukungan Native Push penuh.
T: Dapatkah perangkat non-Cams (ZkTeco, eSSL, BioMax, dll.) memakai API ini?
Ya, dengan Protocol Update. Perangkat non-Cams dan yang belum terverifikasi beroperasi melalui Hybrid Push. Beberapa fitur mungkin terbatas tergantung pada mode koneksi dan kemampuan perangkat keras.
Ya, dengan Protocol Update. Perangkat non-Cams dan yang belum terverifikasi beroperasi melalui Hybrid Push. Beberapa fitur mungkin terbatas tergantung pada mode koneksi dan kemampuan perangkat keras.
T: Apa perbedaan antara Native Push dan Hybrid Push?
Native Push: Dukungan API penuh tanpa batasan — semua 38 operasi berfungsi. Tersedia untuk mesin Cams dan perangkat terverifikasi.
Hybrid Push: Untuk perangkat non-Cams/belum terverifikasi. Ketersediaan fitur bergantung pada mode komunikasi (SDK, DB Pull, atau Pemrosesan File). Lihat Mode Koneksi.
Native Push: Dukungan API penuh tanpa batasan — semua 38 operasi berfungsi. Tersedia untuk mesin Cams dan perangkat terverifikasi.
Hybrid Push: Untuk perangkat non-Cams/belum terverifikasi. Ketersediaan fitur bergantung pada mode komunikasi (SDK, DB Pull, atau Pemrosesan File). Lihat Mode Koneksi.
T: Metode biometrik apa yang didukung?
Sidik jari, pengenalan wajah, vena telapak tangan, kartu RFID/proximity, PIN/kata sandi numerik, pemindaian iris, dan pengukuran suhu tubuh (tergantung perangkat).
Sidik jari, pengenalan wajah, vena telapak tangan, kartu RFID/proximity, PIN/kata sandi numerik, pemindaian iris, dan pengukuran suhu tubuh (tergantung perangkat).
T: Beberapa fitur API tidak berfungsi dengan perangkat saya. Mengapa?
Ini bergantung pada (a) mode koneksi — mode DB Pull dan Pemrosesan File hanya mendukung push absensi, bukan API RESTful, dan (b) keterbatasan perangkat keras — beberapa model perangkat mungkin tidak mendukung fitur tertentu di tingkat firmware. Uji dengan perangkat keras Anda dan hubungi dukungan Cams untuk bantuan.
Ini bergantung pada (a) mode koneksi — mode DB Pull dan Pemrosesan File hanya mendukung push absensi, bukan API RESTful, dan (b) keterbatasan perangkat keras — beberapa model perangkat mungkin tidak mendukung fitur tertentu di tingkat firmware. Uji dengan perangkat keras Anda dan hubungi dukungan Cams untuk bantuan.
API Callback (Perangkat → Server)
T: Apa itu API Callback?
API Callback mengirimkan peristiwa real-time dari perangkat biometrik ke server Anda. Saat terjadi absen atau pengguna diubah di perangkat, Cams Protocol Engine segera mengirim POST payload JSON ke Callback URL yang Anda konfigurasikan.
API Callback mengirimkan peristiwa real-time dari perangkat biometrik ke server Anda. Saat terjadi absen atau pengguna diubah di perangkat, Cams Protocol Engine segera mengirim POST payload JSON ke Callback URL yang Anda konfigurasikan.
T: Apa yang harus dibalas server saya?
Selalu kembalikan
Selalu kembalikan
{"status":"done"} dengan HTTP status 200 — bahkan jika pemrosesan internal Anda gagal. Jangan pernah memblokir Cams Protocol Engine. Antrekan pemrosesan berat untuk eksekusi asinkron.T: Apa yang terjadi jika server saya offline saat absen terjadi?
Biometric Gateway menyimpan semua peristiwa dalam cache dan mengirimkannya secara otomatis begitu server Anda kembali online. Tidak ada data yang hilang.
Biometric Gateway menyimpan semua peristiwa dalam cache dan mengirimkannya secara otomatis begitu server Anda kembali online. Tidak ada data yang hilang.
T: Bagaimana menangani absen ganda?
Terapkan logika deteksi duplikat di server Anda dengan kombinasi
Terapkan logika deteksi duplikat di server Anda dengan kombinasi
UserID + LogTime. Absen yang sama dapat dikirim ulang saat pemulihan offline atau percobaan ulang jaringan.T: Jenis absen apa yang didukung?
CheckIn, CheckOut, BreakOut, BreakIn, OverTimeIn, OverTimeOut, MealIn, MealOut. Field InputType menunjukkan metode biometrik yang dipakai: Fingerprint, Face, Palm, Card, atau Password.T: Bagaimana cara kerja template pengguna dalam Callback?
Saat pengguna diperbarui di perangkat (operasi #3–#9), template dapat tiba satu per satu atau berkelompok melalui beberapa callback. Setiap callback hanya membawa template yang berubah — bukan seluruh set. Server Anda harus menggabungkan/upsert dengan
Saat pengguna diperbarui di perangkat (operasi #3–#9), template dapat tiba satu per satu atau berkelompok melalui beberapa callback. Setiap callback hanya membawa template yang berubah — bukan seluruh set. Server Anda harus menggabungkan/upsert dengan
Type + Index sebagai kunci unik. Jangan pernah menimpa semua template pada satu callback.T: Dapatkah saya menerima foto absensi?
Ya. Operasi #10 RealTimeAttendancePhoto mengirim snapshot JPEG berenkode Base64 yang diambil saat absen. Ini terpisah dari callback log absensi (#11) dan tersedia di perangkat dengan dukungan kamera.
Ya. Operasi #10 RealTimeAttendancePhoto mengirim snapshot JPEG berenkode Base64 yang diambil saat absen. Ini terpisah dari callback log absensi (#11) dan tersedia di perangkat dengan dukungan kamera.
T: Apakah Callback menyertakan deteksi suhu dan masker?
Ya, jika perangkat mendukungnya. Objek
Ya, jika perangkat mendukungnya. Objek
PunchLog menyertakan Temperature (pembacaan suhu tubuh) dan FaceMask (boolean — apakah masker wajah terdeteksi).API RESTful (Server → Perangkat)
T: Apa itu API RESTful?
API RESTful memungkinkan server Anda mengirim perintah ke perangkat biometrik — menambah/menghapus pengguna, memuat log, mendaftarkan biometrik, dan mengendalikan akses. Anda mengirim POST JSON ke URL endpoint yang ada di akun API Monitor Anda.
API RESTful memungkinkan server Anda mengirim perintah ke perangkat biometrik — menambah/menghapus pengguna, memuat log, mendaftarkan biometrik, dan mengendalikan akses. Anda mengirim POST JSON ke URL endpoint yang ada di akun API Monitor Anda.
T: Di mana saya menemukan URL endpoint RESTful saya?
Masuk ke akun API Monitor Anda. URL endpoint RESTful dan Service Tag ID (
Masuk ke akun API Monitor Anda. URL endpoint RESTful dan Service Tag ID (
stgid) Anda tercantum di sana.T: Berapa latensi untuk perintah RESTful?
Sekitar 15 detik. Biometric Gateway memasukkan perintah Anda ke antrean dan mengirimkannya ke perangkat saat perangkat terhubung berikutnya (hampir terus-menerus untuk perangkat online).
Sekitar 15 detik. Biometric Gateway memasukkan perintah Anda ke antrean dan mengirimkannya ke perangkat saat perangkat terhubung berikutnya (hampir terus-menerus untuk perangkat online).
T: Berapa rentang tanggal maksimum untuk LoadLog?
Maksimum yang disarankan adalah 30 hari per permintaan. Untuk rentang yang lebih besar, buat beberapa permintaan dengan jendela waktu berurutan.
Maksimum yang disarankan adalah 30 hari per permintaan. Untuk rentang yang lebih besar, buat beberapa permintaan dengan jendela waktu berurutan.
T: Dapatkah saya menambahkan pengguna dengan beberapa template biometrik sekaligus?
Ya. Array Template menerima beberapa entri. Misalnya, operasi #27 menambahkan pengguna dengan Card + Fingerprint + Password + Face + Palm + UserPhoto sekaligus dalam satu permintaan.
Ya. Array Template menerima beberapa entri. Misalnya, operasi #27 menambahkan pengguna dengan Card + Fingerprint + Password + Face + Palm + UserPhoto sekaligus dalam satu permintaan.
T: Apa yang terjadi jika perangkat offline saat saya mengirim perintah RESTful?
Biometric Gateway memasukkan perintah ke antrean dan mengirimkannya secara otomatis saat perangkat tersambung kembali. Anda akan menerima kode status
Biometric Gateway memasukkan perintah ke antrean dan mengirimkannya secara otomatis saat perangkat tersambung kembali. Anda akan menerima kode status
5 (Perangkat Offline) jika perangkat tidak merespons dalam batas waktu.T: Bagaimana cara memeriksa hasil perintah?
Respons RESTful menyertakan field
Respons RESTful menyertakan field
StatusCode. Kode 0 berarti berhasil. Lihat Kode Status Respons untuk daftar lengkap kode kesalahan dan artinya.T: Dapatkah saya memicu pendaftaran sidik jari dari jarak jauh?
Ya. Operasi #35 EnrollFingerPrint memicu sesi pendaftaran di perangkat. Namun, pengguna harus hadir secara fisik di perangkat untuk memindai jarinya.
Ya. Operasi #35 EnrollFingerPrint memicu sesi pendaftaran di perangkat. Namun, pengguna harus hadir secara fisik di perangkat untuk memindai jarinya.
Keamanan & Jaringan
T: Dapatkah saya memakai HTTPS untuk callback?
Ya. HTTPS dengan sertifikat SSL yang valid pada port 443 didukung sepenuhnya dan disarankan untuk produksi.
Ya. HTTPS dengan sertifikat SSL yang valid pada port 443 didukung sepenuhnya dan disarankan untuk produksi.
T: Apakah enkripsi wajib?
Tidak. Enkripsi AES-256 bersifat opsional. Untuk mengaktifkannya, konfigurasikan Security Key di API Monitor. Setelah aktif, semua payload JSON dienkripsi/didekripsi menggunakan AES/ECB/PKCS5PADDING dengan pengodean Base64.
Tidak. Enkripsi AES-256 bersifat opsional. Untuk mengaktifkannya, konfigurasikan Security Key di API Monitor. Setelah aktif, semua payload JSON dienkripsi/didekripsi menggunakan AES/ECB/PKCS5PADDING dengan pengodean Base64.
T: Bagaimana memvalidasi bahwa callback benar-benar berasal dari Cams?
Setiap callback menyertakan field
Setiap callback menyertakan field
AuthToken. Bandingkan dengan token yang dikonfigurasi di API Monitor Anda. Tolak setiap permintaan dengan token yang tidak cocok.T: Port mana yang harus saya buka?
Port
Port
80 (HTTP) atau 443 (HTTPS) untuk produksi. Port 8123 hanya tersedia untuk pengujian. Lihat Port yang Didukung.T: Bagaimana menguji secara lokal tanpa deploy ke server?
Gunakan IP publik dengan port forwarding, atau alat tunneling seperti ngrok. Lihat Pengujian Lokal untuk panduan langkah demi langkah.
Gunakan IP publik dengan port forwarding, atau alat tunneling seperti ngrok. Lihat Pengujian Lokal untuk panduan langkah demi langkah.
Pertimbangan Data & Desain
T: Format data apa yang dipakai API?
Semua permintaan dan respons berupa JSON mentah dengan enkoding UTF-8. Gunakan header
Semua permintaan dan respons berupa JSON mentah dengan enkoding UTF-8. Gunakan header
Content-Type: application/json. Tanpa form encoding.T: Format stempel waktu apa yang dipakai?
YYYY-MM-DD HH:mm:ss GMT +OFFSET (mis. 2020-09-17 07:48:22 GMT +0530). Field Time dalam UTC; stempel waktu lokal perangkat (seperti LogTime, OperationTime) dapat memakai offset zona waktu yang berbeda.T: Bagaimana menangani absen offline dan data retroaktif?
Rancang aplikasi Anda agar menerima absen yang tiba tidak berurutan secara kronologis. Saat perangkat offline, ia akan mengirim absen yang tersimpan di cache setelah tersambung kembali. Anda mungkin perlu memperbarui status kehadiran secara retroaktif (mis. mengubah pengguna yang tampil "absen" menjadi "hadir").
Rancang aplikasi Anda agar menerima absen yang tiba tidak berurutan secara kronologis. Saat perangkat offline, ia akan mengirim absen yang tersimpan di cache setelah tersambung kembali. Anda mungkin perlu memperbarui status kehadiran secara retroaktif (mis. mengubah pengguna yang tampil "absen" menjadi "hadir").
T: Bagaimana menentukan IN/OUT jika pengguna memiliki beberapa perangkat?
Urutkan semua absen pengguna berdasarkan
Urutkan semua absen pengguna berdasarkan
LogTime di semua perangkat, lalu terapkan logika bisnis Anda. Jangan hanya mengandalkan field Type (CheckIn/CheckOut) dari satu perangkat jika pengguna melakukan absen di mesin yang berbeda.T: Apa itu OperationID dan bagaimana memakainya?
String pengenal unik untuk setiap operasi. Untuk callback masuk, dihasilkan oleh Biometric Gateway. Untuk permintaan RESTful keluar, Anda sebaiknya membuat yang unik per permintaan (UUID atau berbasis stempel waktu). Respons mengembalikannya sehingga Anda dapat mengorelasikan pasangan permintaan/respons.
String pengenal unik untuk setiap operasi. Untuk callback masuk, dihasilkan oleh Biometric Gateway. Untuk permintaan RESTful keluar, Anda sebaiknya membuat yang unik per permintaan (UUID atau berbasis stempel waktu). Respons mengembalikannya sehingga Anda dapat mengorelasikan pasangan permintaan/respons.
T: Bagaimana template biometrik disimpan dan dikirim?
Data biometrik (sidik jari, wajah, telapak tangan, foto pengguna) dienkode Base64 pada field
Data biometrik (sidik jari, wajah, telapak tangan, foto pengguna) dienkode Base64 pada field
Data objek Template. Template sidik jari dan wajah juga menyertakan Size (panjang byte) dan Index (nomor slot). Nomor kartu dan PIN berupa string biasa.Harga & Lisensi
T: Bagaimana API dilisensikan?
Per mesin biometrik. Tahun pertama memerlukan Aktivasi API + Lisensi Tahunan. Tahun-tahun berikutnya hanya memerlukan perpanjangan lisensi tahunan. Lihat Biaya API untuk harga.
Per mesin biometrik. Tahun pertama memerlukan Aktivasi API + Lisensi Tahunan. Tahun-tahun berikutnya hanya memerlukan perpanjangan lisensi tahunan. Lihat Biaya API untuk harga.
T: Apa yang terjadi jika lisensi API saya kedaluwarsa?
Komunikasi API untuk perangkat tersebut berhenti hingga lisensi diperpanjang. Data Anda yang ada tidak terpengaruh, tetapi callback atau perintah RESTful baru tidak akan diproses.
Komunikasi API untuk perangkat tersebut berhenti hingga lisensi diperpanjang. Data Anda yang ada tidak terpengaruh, tetapi callback atau perintah RESTful baru tidak akan diproses.
T: Apakah ada opsi on-premise?
Ya. Protocol Engine Lite dapat dipasang di server Anda sendiri (Windows/Linux) untuk lingkungan khusus LAN atau yang dihosting sendiri. Hubungi sales@camsbiometrics.com untuk detailnya.
Ya. Protocol Engine Lite dapat dipasang di server Anda sendiri (Windows/Linux) untuk lingkungan khusus LAN atau yang dihosting sendiri. Hubungi sales@camsbiometrics.com untuk detailnya.
Informasi Tambahan
SDK Absensi Biometrik
Cams tidak menyediakan SDK tradisional. Semua operasi memakai API HTTP Callback dan RESTful standar — tanpa instalasi pustaka.
Tanpa SDK. Komunikasi ditangani sepenuhnya melalui Cams Protocol Engine menggunakan Callback URL dan endpoint HTTP RESTful.
Ini membuat integrasi mudah dengan platform web apa pun:
OpenERPERPNextZoho PeopleSAPTallyHRAPPOdooAplikasi Web Khusus
Informasi Tambahan
Biaya API
Lisensi API ditagihkan per mesin biometrik. Tahun pertama = aktivasi + lisensi; tahun berikutnya = hanya perpanjangan lisensi.
| Layanan | USD | Catatan |
|---|---|---|
| Native Push — Mesin Cams & Perangkat Terverifikasi | ||
| Aktivasi API | $120 | Sekali per mesin. |
| Lisensi API Tahunan | $60 – $120 | Perpanjangan tahunan diperlukan. |
| Protocol Update (non-Cams) | $120 – $280 | Sekali bayar. Mengaktifkan protokol Cams pada perangkat non-Cams. |
| Hybrid Push — ZKTeco, eSSL & Semua Merek Pihak Ketiga | ||
| Aktivasi API | $150 | Sekali per mesin. |
| Lisensi API Tahunan | $90 – $150 | Perpanjangan tahunan diperlukan. |
| Hybrid Connector (belum terverifikasi) | $150 – $300 | Sekali bayar. Diperlukan untuk perangkat belum terverifikasi yang memakai Hybrid Push. |
| Perangkat Keras & Lainnya | ||
| Perangkat keras | $220 – $720 | Bervariasi menurut model. |
Protocol Engine Lite (on-premise) — Untuk lingkungan khusus LAN atau yang dihosting sendiri. Biaya: $500–$10,000. Hubungi tim penjualan untuk detailnya.