Pendahuluan
Cams Biometric Gateway — Web API 3.0
Cams Biometric Gateway adalah Biometric API universal yang menghubungkan setiap mesin absensi atau kontrol akses biometrik dengan aplikasi Anda — ERP, HRMS, penggajian, manajemen sekolah, perangkat lunak khusus, atau alur kerja AI/otomasi. API ini mendukung semua merek perangkat utama dan menyediakan Biometric API JSON-over-HTTP yang terstandar apa pun perangkat kerasnya.
38 Operasi — 11 API Callback (Perangkat → Server) dan 27 API RESTful (Server → Perangkat). Semua payload berupa JSON mentah melalui HTTP/HTTPS.
Semua mesin biometrik didukung. Mesin Cams, perangkat terverifikasi, dan merek pihak ketiga (ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime/Startek, Biomax, Secugen, eSSL, Matrix COSEC, dan lainnya). Pilih
mode koneksi yang sesuai dengan pengaturan Anda.
Cara Kerja
Biometric Gateway terdiri dari:
Server GatewayPlatform berbasis cloud yang mencakup Cams Protocol Engine (penerjemahan protokol, normalisasi data, cache offline, autentikasi) dan lapisan API Terstandar yang memberikan antarmuka konsisten bagi aplikasi Anda.
Protocol EngineMesin inti di dalam Server Gateway yang berkomunikasi dengan perangkat biometrik, menerjemahkan protokol khusus vendor, serta menangani pencatatan transaksi data yang aman dan manajemen identitas.
Protocol Engine LiteVersi on-premise yang dapat dipasang di server Anda sendiri (Windows/Linux) untuk lingkungan khusus LAN atau yang dihosting sendiri. API sama, di-deploy secara lokal.
Terintegrasi Dengan
OdooERPNextSAPMicrosoft Dynamics
ZohoBitrix24
OrangeHRMBayZatPalmHRuKnowva
FedenaTeachmintEduBricz
RazorPayPayruler
n8nMakeZapier
Claude (MCP)GeminiChatGPT
Aplikasi Web Khusus
Aplikasi Anda
ERP
HRMS
Penggajian
ERP Sekolah
Alur Kerja AI (n8n, Zapier)
MCP — Claude · Gemini · ChatGPT
Aplikasi Khusus
Protocol Engine
Pemrosesan Autentikasi Aman
Pencatatan Transaksi Data
Penerjemahan Protokol
Cache Offline & Antrean
Enkripsi AES-256 · Validasi Auth Token
Lapisan API Terstandar
Manajemen Identitas
Integrasi AI / MCP
Dispatcher Callback
Router Perintah REST
Normalisasi Data · Dukungan Protokol Multi-merek
Sidik Jari
·
Pengenalan Wajah
·
Vena Telapak Tangan
·
Kartu RFID
·
PIN
·
QR / Barcode
·
Pelacakan GPS
Perangkat Biometrik — Semua Merek Didukung
Cams
ZKTeco
Suprema
Hikvision
Anviz
Morpho / IDEMIA
Virdi
Mantra
Nitgen
Realtime
Biomax
Secugen
eSSL
Matrix
+ Banyak Lagi
| Jenis API | Arah | Latensi | Kasus Penggunaan |
|---|
| API Callback | Perangkat → Server Anda | Real-time / tanpa latensi | Menerima data absensi (punch) dan peristiwa sinkronisasi pengguna |
| API RESTful | Server Anda → Perangkat | ~15 detik | Tambah/hapus pengguna, muat log, daftarkan biometrik |
Pendahuluan
Memulai
Integrasikan dalam tiga langkah. Server Anda memerlukan URL yang dapat dijangkau publik untuk menerima callback.
1
Konfigurasikan Callback URL Anda
Masuk ke portal API Monitor. Atur URL HTTPS publik server Anda sebagai Callback URL untuk perangkat Anda. Mesin API akan mengirim POST peristiwa biometrik ke endpoint ini secara real-time.
2
Terima data absensi
Endpoint Anda menerima POST dengan body JSON mentah — tidak diperlukan query parameter untuk API Callback. Validasi AuthToken, parsing data absensi, lalu balas dengan {"status":"done"}.
3
Panggil API RESTful untuk mengelola pengguna & perangkat
POST perintah JSON ke URL endpoint RESTful yang tersedia di akun API Monitor Anda, dengan stgid (Service Tag ID) sebagai query parameter. Mesin memasukkan perintah ke antrean dan perangkat mengonfirmasi dalam ~15 detik.
Format Endpoint
| Jenis API | Metode | Cara mengirim |
|---|
| API Callback (masuk) |
POST |
Perangkat mengirim ke URL yang Anda konfigurasikan. Body JSON mentah; tanpa parameter. |
| API RESTful (keluar) |
POST |
Anda mengirim POST ke URL endpoint RESTful (ada di akun API Monitor Anda) dengan ?stgid=YOUR_SERVICE_TAG_ID dan body JSON mentah. |
Selalu balas permintaan Callback dengan segera. Server Anda harus mengembalikan {"status":"done"} (HTTP 200) untuk mengonfirmasi penerimaan. Jangan lakukan pemrosesan berat sebelum membalas — masukkan ke antrean.
Dokumentasi
Dokumentasi API
Referensi dibagi per topik. Mulailah dengan kompatibilitas perangkat, lalu operasi callback dan REST.
Perangkat yang didukung dan mode koneksiMesin mana yang didukung Gateway, bagaimana masing-masing terhubung (Native Push atau Hybrid Push), dan operasi API apa yang tersedia di setiap mode.
Referensi API: arsitektur, field, dan kode statusKomponen dasar yang dipakai semua operasi: alur permintaan, field JSON umum, jenis template, kode status, port, dan enkripsi payload.
API Callback: peristiwa real-time dari perangkat ke server AndaSetiap peristiwa yang dikirim perangkat ke callback URL Anda, beserta JSON yang diterima server Anda dan respons yang harus dikembalikan.
API RESTful: perintah dari server Anda ke perangkatPerintah yang dikirim server Anda ke perangkat melalui Gateway, dengan JSON permintaan dan respons untuk masing-masing.
Menguji API secara lokalCara menerima callback perangkat di mesin pengembangan dan menguji perintah REST dengan Postman sebelum Anda melakukan deploy.
Contoh PHP: simpan absensi biometrik di MySQLHandler callback PHP yang berfungsi untuk menyimpan data absensi ke MySQL, dalam tiga langkah.
Prompt pembuat kode AISalin prompt ke asisten AI Anda untuk menghasilkan kode integrasi bagi stack Anda sendiri.
FAQ, SDK, dan biayaPertanyaan umum dari para integrator, serta cara kerja SDK dan harga API.
