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
↑ API Callback Gateway → Server Anda (Push)
↓ API RESTful Server Anda → Gateway (Perintah)
Biometric Gateway
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
Internet
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
Semua komunikasi berupa JSON melalui HTTP/HTTPS  ·  Enkripsi AES-256 opsional  ·  www.camsbiometrics.com
Jenis APIArahLatensiKasus Penggunaan
API CallbackPerangkat → Server AndaReal-time / tanpa latensiMenerima data absensi (punch) dan peristiwa sinkronisasi pengguna
API RESTfulServer Anda → Perangkat~15 detikTambah/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 APIMetodeCara 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.
Informasi Tambahan

Hubungi Kami

Untuk dukungan API, kompatibilitas perangkat, atau pertanyaan penjualan:

Penjualan & Dukungan

Emailsales@camsbiometrics.com
WhatsApp+91-98-409-81006 (Dukungan)
Penjualan+91-98-409-41006

Sumber Daya Pengembang

Forumforum.camsbiometrics.com
Perangkatdeveloper.camsbiometrics.com
Produkcamsbiometrics.com/product

Cams Biometrics (Dheeram Innovations Pvt Ltd) — No: 2/98D, Lantai 2, Gedung Cams Biometrics, Seberang Universitas Satyabama, Semmancheri, OMR, Chennai – 600119, India.

Digunakan untuk

Kantin nontunaiKenali setiap pengunjung kantin lewat wajah atau sidik jari, potong subsidi makan secara otomatis, dan hentikan praktik makan atas nama orang lain.See the solution →Lokasi konstruksiAbsensi tanpa sentuhan yang tetap andal meski berdebu dan memakai sarung tangan, terhubung ke ERP dan penggajian Anda.See the solution →Armada, transportasi, dan pengemudiVerifikasi identitas pengemudi di depo atau di kabin dan catat jam kerja untuk TMS dan penggajian Anda.See the solution →Forklift dan penanganan materialHanya operator bersertifikat yang dapat menyalakan kendaraan. Setiap penyalaan dan setiap penolakan dicatat.See the solution →Gym, klub, dan kebugaranCheck-in anggota tanpa sentuhan, keanggotaan divalidasi, turnstile atau pintu terbuka.See the solution →Manajemen pengunjungCheck-in wajah di resepsionis dengan akses yang berakhir otomatis dan log audit lengkap.See the solution →Sekolah, perguruan tinggi, dan kampusAbsensi siswa dan staf tanpa sentuhan, disinkronkan ke software sekolah Anda secara real time.See the solution →Acara, festival, dan stadionMasuk dengan wajah atau gelang yang terhubung ke turnstile dan palang, dengan jumlah pengunjung langsung per gerbang.See the solution →