
Integrasi kunci ke dalam aplikasi, PMS, atau platform bangunan dilakukan melalui dua rangkaian alat yang berbeda: cloud API untuk operasi jarak jauh dan Bluetooth SDK untuk kendali ponsel dalam jangkauan. Mencampur keduanya adalah kesalahan perencanaan integrasi yang paling umum terjadi.
Ketika aplikasi pihak ketiga perlu mengoperasikan kunci pintar — saluran sewa yang menerbitkan kode, platform kantor yang Hormone pengunjung, atau aplikasi hotel yangyms岛 delivers kunci seluler — vendor kunci menyediakan antarmuka yang dapat diprogram dalam dua lapisan. Cloud API biasanya merupakan layanan bergaya REST melalui HTTPS: aplikasi mengautentikasi menggunakan kredensial bergaya OAuth, membuat kode sandi atau ekey, mengirim perintah buka jarak jauh untuk kunci yang daring, menanyakan status kunci, dan menerima callback webhook untuk peristiwa buka, baterai lemah, dan gangguan. Mobile SDK adalah pustaka yang disematkan dalam aplikasi iOS atau Android milik integrator sendiri, yang menangani penemuan Bluetooth, koneksi aman, buka dalam jangkauan, dan logika kredensial luring tanpa perlu melakukan perjalanan bolak-balik ke server. Integrasi yang berhasil sengaja menggunakan kedua lapisan, mengamankan kredensial, serta menguji batas laju dan pengiriman peristiwa sebelum peluncuran. Panduan ini memetakan konsep dan pertanyaan vendor yang penting. Ketersediaan API dan SDK, cakupan, serta lisensi untuk setiap platform dikonfirmasi secara tertulis dalam penawaran.
| Cloud API | Layanan HTTPS mengelola kunci, kredensial, dan peristiwa dari server; hanya dapat menjangkau pintu jarak jauh jika kunci sedang daring melalui Wi-Fi atau gateway. |
| Mobile SDK | Pustaka iOS/Android yang disematkan menangani koneksi Bluetooth, buka dalam jangkauan, dan logika luring di dalam aplikasi milik integrator sendiri. |
| Autentikasi | Kredensial klien bergaya OAuth, token berkcakupan, dan webhook bertanda tangan memisahkan platform profesional dari skrip relai terbuka. |
| Kredensial berdasarkan API | Operasi umum membuat kode sandi berjangka waktu, ekey, kartu, dan tautan pengunjung, beserta endpoint untuk daftar, pembaruan, dan pencabutan. |
| Pengiriman peristiwa | Webhook memberi tahu tentang peristiwa buka, penggunaan kode, baterai lemah, dan pintu; perilaku percobaan ulang serta jaminan urutan harus didokumentasikan. |
| Ketergantungan perangkat keras | Perintah jarak jauh hanya dijalankan pada kunci yang daring melalui Wi-Fi atau gateway, sehingga desain API dan topologi perangkat keras harus direncanakan bersama. |
| Kebijakan kami | Kami menyediakan dokumentasi antarmuka, sandbox atau perangkat uji, serta kontak teknis; kredensial produksi dan batasannya berasal dari agreement platform. |
Otomatisasi sisi server (saluran sewa, PMS, pengelolaan pengunjung) dibangun di atas cloud API; aplikasi ponsel bermerek dengan kendali dalam jangkauan atau luring menambahkan Mobile SDK. Produk yang memerlukan keduanya harus merancang model kredensial sebelum menulis kode.
| Tujuan integrasi | Rangkaian alat utama | Ketergantungan utama |
|---|---|---|
| Menerbitkan kode sewa berjangka waktu | Cloud API dari backend pemesanan | Kunci mendukung jenis kode target dan jalur sinkronisasi. |
| Aplikasi tenant bermerek | Mobile SDK ditambah cloud API | Tim aplikasi menangani rilis SDK dan peninjauan toko. |
| Pengiriman kunci seluler hotel | Peristiwa cloud API dari middleware PMS | Cakupan layanan kredensial dan gateway di seluruh pintu. |
| Kios pengelolaan pengunjung | Cloud API untuk kredensial sekali pakai | Zona waktu dan semantik kedaluwarsa divalidasi sejak awal. |
| Concierge jarak jauh langsung | Cloud API untuk membuka kunci ditambah konfirmasi webhook | Hanya kunci yang daring yang dapat menjalankan perintah jarak jauh secara instan. |
| Dompet perusahaan luring | Mobile SDK dengan kredensial lokal yang diamankan | Aturan penyimpanan kunci dan pencabutan pada perangkat. |
API bertemu kenyataan fisik pada titik masuk: gateway, pintu logam, dan beban baterai menentukan apakah panggilan API yang bersih dapat mencapai kunci tepat waktu. Uji perangkat keras dan perangkat lunak secara bersamaan.
| Area penggunaan | Pintu biasa | Pendekatan kunci |
|---|---|---|
| Pintu unit sewa | Kunci Bluetooth dengan gateway per area | Backend pemesanan membuat kode luring dan daring melalui cloud API. |
| Entran kaca kantor | Pembaca daring atau pengendali | Platform pengunjung mengirim kredensial sekali pakai dan menerima webhook masuk. |
| Kamar tamu hotel | Kunci RFID dengan layanan kunci seluler | Middleware PMS memanggil API kunci; gateway mendorong pembaruan langsung. |
| Pintu ruang kerja bersama | Kunci pintar di balik fasad kaca | Aplikasi anggota menyematkan SDK untuk membuka dalam jangkauan bahkan dengan Wi-Fi lemah. |
| Gerbang logistik | Kunci daring untuk area luar ruang | Perintah jarak jauh memerlukan konektivitas terkonfirmasi dan kontak cadangan. |
| Ruang fasilitas | Kunci baterai yang dikelola jarak jauh | Webhook melakukan audit penggunaan fő untuk penagihan dan tinjauan penyalahgunaan dalam aplikasi operator. |
API tampak serupa dalam slide dan berbeda di lingkungan produksi. Sebelum menglokalkan waktu rekayasa, integrator sebaiknya mengumpulkan item berikut, yang seluruhnya kami bantu koordinasikan dengan tim platform.
| Komponen | Logika umum | Catatan |
|---|---|---|
| Referensi API | Endpoint, cakupan, versi, dan ketersediaan sandbox. | Estimasi rekayasa bergantung pada dokumentasi yang lengkap dan(mutakhir). |
| Paket SDK | Versi OS yang didukung, aplikasi contoh, dan ritme rilis. | Persetujuan toko dan model pemeliharaan harus dipahami. |
| Model keamanan | Jenis token, rotasi rahasia, penandatanganan webhook, dan opsi IP. | Melindungi endpoint buka kunci tidak dapat ditawar untuk produksi. |
| Batas dan kuota | Batas laju, pagination, operasi batch, dan aturan percobaan ulang. | Peluncuran armada dapat gagal pada jam check-in puncak. |
| Katalog peristiwa | Jenis peristiwa, payload, urutan, dan jaminan pengiriman ulang. | Fitur audit dan notifikasi bergantung pada peristiwa yang andal. |
API adalah antarmuka dari server ke server: backend Anda memanggil platform kunci melalui HTTPS untuk membuat kode, mengirim perintah buka kunci ke kunci yang daring, memeriksa status, dan menerima peristiwa webhook. API ini berfungsi tanpa bergantung pada kedekatan ponsel. SDK seluler adalah pustaka perangkat lunak yang terintegrasi ke aplikasi iOS atau Android Anda sendiri dan berkomunikasi langsung dengan kunci melalui Bluetooth, sehingga memungkinkan pembukaan kunci di vicinity, konfigurasi, serta penyimpanan kredensial luring ketika server tidak dapat dijangkau. Backend persewaan dan integrasi PMS umumnya hanya memerlukan API cloud; aplikasi penyewa bermerek biasanya memerlukan SDK ditambah panggilan API tertentu. Mencoba melakukan semuanya melalui API — misalnya membuka kunci yang hanya mendukung Bluetooth dari sisi lain dunia tanpa gateway — tidak akan berhasil, sehingga topologi perangkat keras dan pilihan antarmuka harus dirancang secara bersamaan. Antarmuka yang tersedia untuk setiap platform dikonfirmasi secara tertulis dalam setiap penawaran.
Ya, ini merupakan pola integrasi standar: ketika reservasi dikonfirmasi, backend atau middleware Anda memanggil API platform kunci dengan informasi kamar atau unit, tanggal kedatangan dan keberangkatan, lalu menerima kode sandi atau ekey yang dikirimkan kepada tamu melalui templat pesan atau email Anda sendiri. Selanjutnya, webhook mengonfirmasi penggunaan dan menandai peristiwa seperti upaya check-in lebih awal atau baterai lemah. Persyaratan yang perlu ditetapkan meliputi penanganan zona waktu untuk rentang tanggal, jenis kode yang dapat digunakan secara luring pada kunci yang dipilih, cakupan gateway untuk pencabutan langsung, percobaan ulang idempoten saat pesan dikirim ulang, serta cara pembatalan dan perubahan tanggal memperbarui kredensial. Kami menyediakan kunci uji dan mendukung lokakarya integrasi; detail endpoint, batas laju, dan lisensi untuk setiap platform dikonfirmasi secara tertulis dalam setiap penawaran.
Pembukaan jarak jauh aman jika platform dibangun seperti API keuangan terautentikasi mana pun: token bergaya OAuth dengan cakupan terbatas, penyimpanan rahasia di sisi server, izin per staf, konfirmasi perintah melalui webhook, log audit, dan persetujuan dua faktor opsional untuk pintu sensitif. Situasi menjadi berbahaya ketika integrator menyematkan rahasia berumur panjang ke aplikasi ponsel, mengekspos endpoint relai terbuka, atau mencatat URL pembukaan kunci. Pengamanan fisik juga penting: perintah jarak jauh hanya dapat mencapai kunci yang daring, dan pintu dengan keamanan tinggi sering kali menonaktifkan pembukaan jarak jauh sepenuhnya atau memerlukan persetujuan ganda. Dalam proses uji tuntas, mintalah whitepaper keamanan, prosedur rotasi token, dan skema penandatanganan webhook daripada sekadar menerima klaim bahwa “REST API tersedia”. Kami Coordinating peninjauan ini bersama tim platform dan dapat mengusulkan arsitektur yang membatasi pembukaan jarak jauh hanya untuk peran resepsionis.
Webhook merupakan saluran peristiwa standar — catatan pembukaan kunci, dimasukkan kode, baterai lemah, peringatan perusak, dan perubahan sensor pintu — tetapi semantik pengiriman berbeda-beda menurut platform. Platform profesional menandatangani payload, mencoba kembali pengiriman yang gagal dengan jeda progresif, dan menyediakan API untuk melakukan rekonsiliasi atau memeriksa peristiwa yang terlewat. Hal ini penting karena jaringan occasionally mengalami gangguan singkat dan pengiriman duplikat merupakan hal yang normal; oleh karena itu, konsumen harus memperlakukan ID peristiwa secara idempoten. Jaminan urutan lebih lemah: dua peristiwa yang dibuat beberapa detik apartemen kadang dapat tiba dengan urutan terbalik, sehingga logika audit harus menggunakan stempel waktu dari peristiwa kunci, bukan waktu kedatangan. Selama fase pilot, simulasikan penerima yang luring dan verifikasi perilaku pemutaran ulang. Katalog peristiwa, kebijakan percobaan ulang, dan endpoint rekonsiliasi untuk platform yang dipilih terdokumentasi secara tertulis sebelum pengembangan dimulai.
Akses API diberikan oleh platform kunci berdasarkan ketentuan pengembang dan komersialnya sendiri, umumnya kepada pemilik akun: merek atau operator yang memiliki proyek cloud, bukan secara otomatis kepada setiap pembeli kunci. Pabrik dapat membantu mengaktifkan layanan, menyediakan dokumentasi, dan mengoordinasikan orientasi teknis, tetapi tidak dapat memberikan hak di luar perjanjian platform. Beberapa platform membedakan pengguna khusus aplikasi, akun bisnis dengan dasbor, dan mitra pengembang bersertifikat dengan akses API penuh. Sejumlah endpoint lanjutan juga memerlukan tinjauan integrasi yang disetujui. Karena itu, pembeli yang merencanakan integrasi mendalam harus mengonfirmasi kelayakan sebagai pengembang, biaya, ketentuan pemrosesan data, dan wilayah yang didukung sebelum memilih perangkat keras, karena kunci yang sangat baik tanpa hak akses API tidak dapat menjalankan produk yang direncanakan. Program pengembang dan lisensi terkini untuk setiap platform dikonfirmasi dalam setiap RFQ.
Bagikan kasus penggunaan integrasi, tumpukan teknologi tim, dan jadwal peluncuran Anda dalam RFQ. Kami mengoordinasikan dokumentasi API, paket SDK, perangkat uji, dan perjanjian platform, serta mendukung pilot bersama yang mencakup kondisi luring, percobaan ulang, dan peristiwa dalam skala armada.
Minta Lembar Spesifikasi + PenawaranIkhtisar teknologiTerakhir diperbarui: 31 Oktober 2026 · Ditinjau oleh tim editorial Smart Lock Factory
Bagikan kasus penggunaan integrasi, tumpukan teknologi tim, dan jadwal peluncuran Anda melalui RFQ. Kami mengoordinasikan dokumentasi API, paket SDK, perangkat uji, dan perjanjian platform, serta mendukung pilot bersama yang mencakup penggunaan luring, percobaan ulang, dan peristiwa dalam skala armada.
Minta Lembar Spesifikasi + PenawaranIkhtisar teknologiTerakhir diperbarui: 31 Oktober 2026 · Ditinjau oleh tim editorial Smart Lock Factory