API access control adalah antarmuka yang memungkinkan aplikasi perusahaan, seperti HRIS, ERP, aplikasi tamu, atau sistem membership, membaca dan mengubah data di gate system secara otomatis. Artikel ini ditujukan untuk tim IT yang akan menghubungkan gate dengan aplikasi internal: fungsi apa yang biasanya dibutuhkan, pola komunikasinya, dan hal teknis yang perlu diputuskan sebelum mulai.
Gambaran besar lapisan gate system dibahas di panduan integrasi gate system.
Contoh penerapan API ini pada gate, kartu, dan face recognition dapat dilihat di sistem akses kontrol Centergate.
Fungsi yang Umumnya Dibutuhkan
| Kelompok | Contoh operasi |
|---|---|
| Pengguna | Tambah, ubah, nonaktifkan, atau hapus pengguna; cari pengguna berdasarkan ID |
| Kredensial | Daftarkan atau cabut nomor kartu RFID, data wajah, atau QR code |
| Hak akses | Tentukan gate atau area yang boleh dilalui serta jadwal berlakunya |
| Log akses | Ambil riwayat akses berdasarkan rentang waktu, pengguna, atau gate |
| Kendali gate | Buka gate dari jarak jauh, atau ubah mode (normal, selalu terbuka, terkunci) |
| Status perangkat | Cek apakah gate, reader, atau controller sedang online |
| Tamu | Buat akses sementara dengan masa berlaku tertentu |
Dua Pola Komunikasi
- Request dari aplikasi Anda (pull): aplikasi memanggil API, misalnya untuk menambah karyawan atau mengambil log satu hari. Cocok untuk perubahan data dan laporan.
- Kiriman dari gate system (push atau webhook): gate system memanggil URL milik aplikasi Anda setiap kali terjadi kejadian, misalnya akses diterima atau ditolak. Cocok untuk absensi real-time, notifikasi keamanan, atau dashboard.
Integrasi yang sehat biasanya memakai keduanya: pull untuk mengelola data, push untuk kejadian.
Keputusan Teknis Sebelum Mulai
- Sumber kebenaran data: sistem mana yang menjadi acuan data pengguna? Bila HRIS, perubahan sebaiknya hanya dilakukan di HRIS lalu dikirim ke gate system.
- Autentikasi: API key atau token, dengan komunikasi lewat HTTPS. Batasi akses per aplikasi.
- Penanganan gagal kirim: bila aplikasi Anda sedang tidak bisa dihubungi, kejadian perlu diantrekan dan dikirim ulang, bukan hilang.
- Pencegahan data ganda: setiap kejadian sebaiknya memiliki ID unik agar pengiriman ulang tidak tercatat dua kali.
- Mode offline: perangkat di lokasi sebaiknya tetap dapat memvalidasi akses dan menyimpan log saat koneksi ke server terputus.
- Lingkungan uji: siapkan data uji dan, bila memungkinkan, satu gate uji sebelum menyentuh gate produksi.
Keamanan dan Pelindungan Data Pribadi
Gate system menyimpan data pribadi karyawan dan tamu, termasuk data wajah bila memakai face recognition. Di Indonesia, pengolahan data pribadi diatur oleh Undang-Undang Nomor 27 Tahun 2022 tentang Pelindungan Data Pribadi, yang menggolongkan data biometrik sebagai data pribadi yang bersifat spesifik. Hal praktis yang perlu disepakati:
- Data apa saja yang benar-benar perlu dikirim lewat API, dan siapa yang boleh mengaksesnya.
- Di mana data disimpan dan berapa lama log dipertahankan.
- Bagaimana data dihapus saat karyawan keluar atau tamu selesai berkunjung.
- Pencatatan siapa yang mengakses atau mengubah data melalui API.
Checklist Uji Sebelum Go-Live
- Pengguna baru dari aplikasi Anda bisa melewati gate yang diizinkan, dan tertolak di gate lain.
- Pengguna yang dinonaktifkan langsung tertolak.
- Kejadian akses sampai ke aplikasi Anda dengan waktu dan lokasi yang benar.
- Saat aplikasi Anda dimatikan sementara, kejadian terkirim ulang setelah aplikasi aktif kembali, tanpa duplikat.
- Saat jaringan ke server diputus, gate tetap bekerja sesuai aturan yang disepakati.
Center Gate menyediakan custom software dan integrasi API untuk gate system, dikerjakan oleh tim programmer sendiri. Untuk gate yang sudah terpasang, lihat juga cara mengecek apakah gate lama bisa diintegrasikan.
Pertanyaan yang Sering Diajukan
Apa beda API dan SDK pada perangkat gate?
SDK adalah pustaka dari produsen perangkat untuk berkomunikasi langsung dengan perangkat tertentu. API biasanya disediakan oleh software gate system agar aplikasi lain dapat bertukar data tanpa perlu tahu detail tiap perangkat.
Apakah gate bisa dibuka dari aplikasi kami?
Bisa, bila software gate system menyediakan fungsi kendali jarak jauh. Fungsi ini sebaiknya dibatasi untuk pengguna tertentu dan selalu tercatat di log.
Apakah data wajah perlu dikirim ke aplikasi kami?
Umumnya tidak. Aplikasi Anda cukup menerima ID pengguna dan hasil verifikasi, sementara data wajah tetap di gate system. Ini juga mengurangi risiko pelindungan data pribadi.
