Beranda / Produk / API / Biometric Gateway Web API

API

Biometric Gateway Web API

Biometric Gateway Web API (juga dikenal sebagai Universal Biometric Web API 3.0) mengubah perangkat sidik jari, wajah, telapak tangan, vena, iris, retina, kartu, atau kata sandi yang didukung menjadi endpoint terhubung cloud yang dapat diakses aplikasi Anda dari mana saja di dunia. Terima absen real-time seketika saat terjadi dan kelola pengguna di perangkat dari jarak jauh, semuanya melalui kontrak REST plus Callback yang sederhana.

Mulai Dokumentasi pengembang

Ikhtisar

Hubungkan perangkat absensi biometrik atau kontrol akses berkemampuan internet langsung ke aplikasi web Anda melalui HTTP — tanpa perangkat lunak lokal, PC, atau database.

Web API unggulan Cams memungkinkan komunikasi mesin-ke-server antara perangkat biometrik yang terpasang jarak jauh dan aplikasi server Anda. Perangkat terhubung ke internet, absensi dikirim ke Callback URL (webhook) Anda secara real-time, dan server Anda menjalankan operasi perangkat seperti tambah atau hapus pengguna, kirim template, kirim foto, dan muat log absen melalui panggilan RESTful. Tidak perlu memasang perangkat lunak desktop, menjalankan database lokal, atau menyalakan PC di LAN. API ini tidak bergantung pada database dan bekerja dengan bahasa backend apa pun.

APIRESTCallback/Webhook (HTTP POST)MQTT (jalur koneksi persisten EMQX)PHPPythonJavaNode.js

Digunakan di:Manajemen Pengunjung Acara, Festival & Stadion

Callback (webhook) — absen real-time

# Your Callback URL receives every punch in real time
POST https://yourapp.com/cams/callback
{
  "DeviceSN": "SN7A2300583",
  "EmployeeCode": "1042",
  "AttendanceLog": "2026-06-21 09:02:14",
  "Type": "face",
  "Direction": "CheckIn"
}

Kemampuan

Apa yang dilakukannya

Absensi Real-Time

Absen dikirim ke Callback URL Anda seketika dicatat di perangkat.

Manajemen Pengguna Jarak Jauh

Tambah, hapus, blokir, dan pindahkan pengguna serta kirim template atau foto ke perangkat dari server Anda melalui panggilan RESTful.

Pengambilan Multi-Modal

Satu kontrak menangani input sidik jari, wajah, telapak tangan, vena, iris, retina, kartu, dan kata sandi.

Tahan Terhadap Kondisi Offline

Absen saat offline disangga di perangkat dan dikirim ulang berurutan setelah konektivitas pulih.

Transport Terenkripsi

Enkripsi data mentah AES-256 dapat diaktifkan per perangkat untuk pertukaran data yang aman.

Fitur

Semua sudah termasuk

Callback (webhook) API mengirimkan absen absensi real-time dari perangkat ke server Anda tanpa latensi polling
API RESTful untuk operasi server-ke-perangkat: Add User, Add User with Templates, Add User Photo, Delete User, Delete All Users, Load Punchlog, dan lainnya (38 operasi)
Menangkap berbagai jenis input per absen: Fingerprint, Face, Card, Palm, Finger Vein, Iris, Retina, Password, plus flag Suhu Tubuh dan Masker Wajah jika didukung perangkat keras
Jenis absen meliputi CheckIn, CheckOut, BreakIn, BreakOut, OverTimeIn, OverTimeOut, MealIn, MealOut
Menangani absen offline: data yang diantrekan dikirim berurutan saat perangkat tersambung kembali
Enkripsi AES-256 opsional untuk semua data mentah yang dipertukarkan, dengan kunci keamanan yang diatur di API Monitor
LoadLog API memungkinkan aplikasi non-server dan khusus LAN menarik hingga 30 hari riwayat absensi sesuai permintaan
Kode status terdokumentasi untuk penanganan error yang andal, dengan AuthToken per perangkat dan pelacakan OperationID untuk dukungan dan rekonsiliasi

Bangun dengan Biometric Gateway Web API

Ambil kunci, baca dokumentasi, dan rilis. Tim kami membantu integrasi pertama Anda.

Bicara dengan engineer WhatsApp

FAQ

Pertanyaan umum

Apakah saya perlu memasang perangkat lunak di jaringan lokal untuk menggunakan Web API?

Tidak. Komunikasi terjadi melalui HTTP antara perangkat dan server Anda. Selama perangkat terhubung ke internet, Anda dapat menerima absensi dan mengelola pengguna tanpa perangkat lunak lokal, database, atau PC.

Input biometrik apa saja yang didukung Web API?

Sidik jari, wajah, kartu, telapak tangan, vena jari, iris, retina, dan kata sandi, plus data Suhu Tubuh dan Masker Wajah jika disediakan perangkat keras.

Apa perbedaan antara Callback API dan RESTful API?

Callback API adalah komunikasi real-time perangkat-ke-server melalui URL yang Anda sediakan di server Anda (tanpa latensi). RESTful API adalah komunikasi server-ke-perangkat yang Anda panggil pada endpoint Cams untuk mengelola perangkat, dengan latensi hingga sekitar 15 detik.

Bisakah saya menggunakan API jika server saya tidak punya IP publik?

Ya. Gunakan LoadLog API untuk menarik log absensi pada rentang waktu tertentu sesuai permintaan, selama perangkat terhubung ke internet.