
Kilitlerin bir uygulamaya, PMS'ye veya bina platformuna entegre edilmesi iki farklı araç setiyle gerçekleşir: uzaktan işlemler için bulut API'leri ve yakın mesafeden telefonla kontrol için Bluetooth SDK'ları. Bunları karıştırmak, entegrasyon planlamasında en yaygın hatadır.
Üçüncü taraf bir uygulamanın akıllı kilitleri işletmesi gerektiğinde — kod üreten bir kiralama kanalı, ziyaretçileri tanımlayan bir ofis platformu veya mobil anahtar sunan bir otel uygulaması — kilit üreticisi iki katmanda programlanabilir arayüzler sunar. Bulut API genellikle HTTPS üzerinden çalışan REST tarzı bir hizmettir: uygulama OAuth tarzı kimlik bilgileriyle kimlik doğrulama yapar; geçici şifreler veya e anahtarları oluşturur; çevrimiçi kilitlere uzaktan kilit açma komutları gönderir; kilit durumunu sorgular ve kilit açma, düşük pil ile müdahale olayları için webhook geri çağrıları alır. Mobil SDK, entegratörün kendi iOS veya Android uygulamasına gömülen; Bluetooth keşfini, güvenli bağlantıyı, yakın mesafeden kilit açmayı ve sunucuya dönüş yapmadan çevrimdışı kimlik bilgisi mantığını yöneten bir kütüphanedir. Başarılı entegrasyonlar her iki katmanı bilinçli olarak kullanır, kimlik bilgilerini güvenceye alır ve lansmandan önce hız sınırlarını ve olay teslimini test eder. Bu kılavuz, kavramları ve önemli tedarikçi sorularını haritalandırır. Her platform için API ve SDK kullanılabilirliği, kapsamları ve lisanslama koşulları teklif başına yazılı olarak doğrulanır.
| Bulut API | HTTPS hizmetleri kilitleri, kimlik bilgilerini ve olayları sunucudan yönetir; kilitler Wi-Fi veya ağ geçidi üzerinden çevrimiçiyse uzaktaki kapılara ulaşır. |
| Mobil SDK | Gömülü iOS/Android kütüphaneleri, entegratörün kendi uygulaması içinde Bluetooth bağlantısını, yakın mesafeden kilit açmayı ve çevrimdışı mantığı yönetir. |
| Kimlik doğrulama | OAuth tarzı istemci kimlik bilgileri, kapsamlı belirteçler ve imzalı webhook'lar profesyonel platformları açık aktarma betiklerinden ayırır. |
| API'ye göre kimlik bilgileri | Yaygın işlemler; tarihli şifreler, e anahtarları, kartlar ve ziyaretçi bağlantıları oluşturur; listeleme, güncelleme ve iptal uç noktaları sunar. |
| Olay teslimi | Webhook'lar kilit açma, şifre kullanımı, düşük pil ve kapı olaylarını bildirir; yeniden deneme davranışı ve sıralama garantileri belgelenmelidir. |
| Donanım bağımlılığı | Uzaktaki komutlar yalnızca Wi-Fi veya ağ geçidi üzerinden çevrimiçi kilitlerde yürütülür; bu nedenle API tasarımı ile donanım topolojisi birlikte planlanmalıdır. |
| Politikamız | Arayüz belgeleri, sandbox veya test cihazları ve teknik bir iletişim noktası sağlarız; üretim kimlik bilgileri ve sınırlar platform sözleşmesinden gelir. |
Sunucu tarafı otomasyon (kiralama kanalları, PMS, ziyaretçi yönetimi) bulut API üzerine kurulur; yakın mesafe veya çevrimdışı kontrollü markalı telefon uygulamaları mobil SDK'yı ekler. İkisine de ihtiyaç duyan ürünler, kodu yazmadan önce kimlik bilgisi modelini tasarlamalıdır.
| Entegrasyon hedefi | Temel araç seti | Temel bağımlılık |
|---|---|---|
| Tarihli kiralama şifreleri üretmek | Rezervasyon arka uç uçlarından bulut API | Kilitler hedef şifre türünü ve eşitleme yolunu destekler. |
| Markalı kiracı uygulaması | Mobil SDK ve bulut API | Uygulama ekibi SDK sürümlemeyi ve mağaza incelemesini yönetir. |
| Otel mobil anahtar teslimi | PMS ara katmanından bulut API olayları | Kapılarda kimlik bilgisi hizmeti ve ağ geçidi kapsaması. |
| Ziyaretçi yönetimi kiosk'u | Tek kullanımlık kimlik bilgileri için bulut API | Saat dilimleri ve sona erme semantiği baştan doğrulanır. |
| Canlı uzaktan resepsiyon | Bulut API ile kilit açma ve webhook onayı | Yalnızca çevrimiçi kilitler uzaktaki komutları anında yürütür. |
| Çevrimdışı kurumsal cüzdan | Güvenli yerel kimlik bilgileriyle mobil SDK | Cihaz üzerinde anahtar depolama ve iptal kuralları. |
API'ler açılış noktasında fiziksel gerçekle buluşur: ağ geçitleri, metal kapılar ve pil ömrü, temiz bir API çağrısının kilde zamanında ulaşıp ulaşmayacağını belirler. Pilot donanım ve yazılım birlikte test edilmelidir.
| Açılış | Tipik kapı | Kilit yaklaşımı |
|---|---|---|
| Kiralama birimi kapısı | Alan başına ağ geçidine sahip Bluetooth kilit | Rezervasyon arka ucu, bulut API üzerinden çevrimdışı ve çevrimiçi şifreler oluşturur. |
| Ofis cam girişi | Çevrimiçi okuyucu veya kontrolör | Ziyaretçi platformu tek kullanımlık kimlik bilgileri gönderir ve giriş webhook'larını alır. |
| Otel misafir odası | Mobil anahtar hizmetine sahip RFID kilit | PMS ara katmanı anahtar API'sini çağırır; ağ geçidi canlı güncellemeleri iletir. |
| Ortak çalışma alanı kapısı | Cam cephe arkasındaki akıllı kilit | Üye uygulaması, zayıf Wi-Fi'de bile yakın mesafeden kilit açma için SDK'yı gömer. |
| Lojistik kapısı | Çevrimiçi dış mekân kilidi | Uzaktaki komutlar doğrulanmış bağlantı ve yedek iletişim yöntemleri gerektirir. |
| Donanım odası | Uzaktan yönetilen pil kilidi | Webhook denetimleri, operatör uygulamasında faturalama ve kötüye kullanım incelemesini destekler. |
API'ler sunumlarda benzer görünür, üretimde farklılık gösterir. Mühendislik süresini taahhüt etmeden önce entegratörler aşağıdaki unsurları toplamalıdır; bunların tamamını platform ekibiyle birlikte koordine etmemize yardımcı oluruz.
| Bileşen | Tipik mantık | Notlar |
|---|---|---|
| API referansı | Uç noktalar, kapsamlar, sürümler ve sandbox kullanılabilirliği. | Mühendislik tahminleri, eksiksiz ve güncel belgelere bağlıdır. |
| SDK paketi | Desteklenen işletim sistemi sürümleri, örnek uygulamalar ve sürüm yayın sıklığı. | Mağaza onayı ve bakım modelleri anlaşılmalıdır. |
| Güvenlik modeli | Belirteç türleri, gizli bilgi rotasyonu, webhook imzalama ve IP seçenekleri. | Kilit açma uç noktalarının korunması, üretim için vazgeçilmezdir. |
| Sınırlar ve kotalar | Hız sınırları, sayfalama, toplu işlemler ve yeniden deneme kuralları. | Aksi halde filo lansmanları, yoğun giriş saatlerinde başarısız olabilir. |
| Olay kataloğu | Olay türleri, veri yükleri, sıralama ve yeniden teslim garantileri. | Denetim ve bildirim özellikleri güvenilir olaylara bağlıdır. |
API, sunucudan sunucuya bir arayüzdür: arka uç sisteminiz, kodlar oluşturmak, çevrimiçi kilitlere kilit açma komutları göndermek, durum sorgulamak ve webhook olayları almak için kilit platformuna HTTPS üzerinden bağlanır; telefon yakınlığı gerektirmez. Mobil SDK ise kendi iOS veya Android uygulamanıza gömülen ve Bluetooth üzerinden kilitlerle doğrudan iletişim kuran bir yazılım kütüphanesidir; bu sayede yakındaki kilitlerin açılması, kurulum ve sunucuya erişilemediğinde kimlik bilgilerinin çevrimdışı olarak saklanması sağlanır. Kiralama arka uç sistemleri ve PMS entegrasyonları esas olarak bulut API'sine ihtiyaç duyar; markalı kiracı uygulamaları genellikle SDK'yı ve belirli API çağrılarını birlikte kullanır. Her şeyi API üzerinden yapmaya çalışmak — örneğin ağ geçidi olmadan dünyanın herhangi bir yerinden yalnızca Bluetooth destekleyen bir kilidi açmak — işe yaramaz; bu nedenle donanım topolojisi ve arayüz seçimi birlikte tasarlanmalıdır. Platform başına sunulan arayüzler her teklif için yazılı olarak doğrulanır.
Evet, bu standart bir entegrasyon modelidir: rezervasyon onaylandığında arka uç sisteminiz veya ara katmanınız, oda veya ünite ile geliş ve ayrılış tarihlerini belirterek kilit platformu API'sini çağırır ve bir parola kodu veya ekey alır; bu bilgi kendi mesaj veya e-posta şablonunuz üzerinden misafire iletilir. Webhook'lar ardından kullanımı doğrular ve erken check-in girişimleri ya da düşük pil gibi olayları işaretler. Netleştirilmesi gereken noktalar; tarih aralıklarında saat dilimi işleme, seçilen kilitlerde çevrimdışı çalışan kod türü, canlı iptal için ağ geçidi kapsaması, mesajlar yeniden gönderildiğinde idempotent yeniden denemeler ve iptal veya tarih değişikliklerinin kimlik bilgisini nasıl güncelleyeceğidir. Test kilitleri sağlar ve entegrasyon atölyelerine destek veririz; uç nokta ayrıntıları, hız sınırları ve her platform için lisanslama, her teklif kapsamında yazılı olarak doğrulanır.
Uzaktan kilit açma, platform herhangi bir doğrulanmış finansal API gibi kurulduğunda güvenlidir: sınırlı kapsamlara sahip OAuth tarzı belirteçler, sunucu tarafında gizli bilgi depolama, personel bazlı izinler, webhook ile komut onayı, denetim kayıtları ve hassas kapılar için isteğe bağlı iki faktörlü onay kullanılır. Entegratörlerin telefon uygulamalarına uzun ömürlü gizli bilgileri gömmesi, açık röle uç noktalarını kullanıma sunması veya kilit açma URL'lerini kaydetmesi durumunda tehlike oluşur. Fiziksel güvenlik önlemleri de önemlidir: uzaktan komutlar yalnızca çevrimiçi kilitlere ulaşır; yüksek güvenlikli kapılar genellikle uzaktan kilit açmayı tamamen devre dışı bırakır veya çift onay ister. Durum tespiti sırasında, yalnızca “REST API mevcuttur” ifadesini kabul etmek yerine güvenlik teknik dokümanını, belirteç rotasyon prosedürünü ve webhook imzalama şemasını isteyin. Bu incelemeleri platform ekibiyle birlikte yürütür ve uzaktan kilit açmanın yalnızca resepsiyon rollerine sınırlandırıldığı mimariler önerebiliriz.
Webhook'lar standart olay kanalıdır — kilit açma kayıtları, kod girişleri, düşük pil, kurcalama uyarıları ve kapı sensörü değişiklikleri — ancak teslimat anlamları platforma göre değişir. Profesyonel platformlar yükleri imzalar, başarısız teslimatları geri çekilme aralıklarıyla yeniden dener ve kaçırılan olayları uzlaştırmak veya sorgulamak için bir API sağlar; bu, ağların kısa süreli kesintiler yaşaması ve yinelenen teslimatların normal olması nedeniyle önemlidir; bu nedenle tüketiciler olay kimliklerini idempotent olarak işlemelidir. Sıralama garantileri daha zayıftır: saniyeler arayla oluşturulan iki olay ara sıra ters sırada ulaşabilir, bu nedenle denetim mantığı varış zamanı yerine kilit olayının zamanını kullanmalıdır. Pilot aşamasında çevrimdışı bir alıcı simüle edin ve yeniden oynatma davranışını doğrulayın. Seçilen platformun olay kataloğu, yeniden deneme politikası ve uzlaştırma uç noktaları geliştirme başlamadan önce yazılı olarak belgelenir.
API erişimi, kilit platformunun kendi geliştirici ve ticari koşullarına uygun olarak platform tarafından verilir ve genellikle hesap sahibine tanınır: bulut projesine sahip markaya veya işletmeciye; her kilit alıcısına otomatik olarak verilmez. Üretici, hizmetin etkinleştirilmesine yardımcı olabilir, dokümantasyon sağlayabilir ve teknik uyum sürecini koordine edebilir; ancak platform sözleşmesinin öngördüğü hakların ötesinde yetki atayamaz. Bazı platformlar yalnızca uygulama kullanan kullanıcıları, panolar içeren iş hesaplarını ve tam API erişimine sahip onaylı geliştirici ortaklarını birbirinden ayırır; gelişmiş uç noktalardan bazıları ise onaylı entegrasyon incelemesi gerektirir. Bu nedenle derin entegrasyon planlayan alıcılar, donanım seçmeden önce geliştirici uygunluğunu, ücretleri, veri işleme koşullarını ve desteklenen bölgeleri doğrulamalıdır; çünkü API kullanım hakkı olmayan harika bir kilit, planlanan ürünü çalıştırmak için yeterli değildir. Güncel geliştirici programları ve platform başına lisanslama, her RFQ kapsamında doğrulanır.
Entegrasyon kullanım senaryolarınızı, ekibinizin teknoloji yığınını ve lansman takviminizi RFQ'nizle paylaşın. API dokümantasyonunu, SDK paketlerini, test cihazlarını ve platform anlaşmalarını koordine eder, çevrimdışı çalışma, yeniden denemeler ve filo ölçeğindeki olayları kapsayan ortak bir pilot için destek veririz.
Teknik Özellik Sayfası ve Teklif İsteyinTeknoloji genel bakışıSon güncelleme: 31 Ekim 2026 · Smart Lock Factory editör ekibi tarafından incelendi