Akıllı kilit, dizüstü bilgisayar ve ince mavi ışık izleriyle bağlanan yüzen arayüz düğümü grafikleri içeren soyut geliştirici sahnesi, koyu bir masa üzerinde soğuk teknik aydınlatma, insan yok, okunabilir metin yok, logo yok
Teknoloji

Akıllı kilitler için API'ler ve SDK'lar: yazılım kapıları pratikte nasıl açar

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.

Temel bilgiler

API'ler ve SDK'lar bir bakışta

Bulut APIHTTPS 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 SDKGö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ğrulamaOAuth 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 bilgileriYaygı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 teslimiWebhook'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ızArayü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.
Yanıt birimi

Bir proje hangi entegrasyon yoluna ihtiyaç duyar?

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 hedefiTemel araç setiTemel bağımlılık
Tarihli kiralama şifreleri üretmekRezervasyon arka uç uçlarından bulut APIKilitler hedef şifre türünü ve eşitleme yolunu destekler.
Markalı kiracı uygulamasıMobil SDK ve bulut APIUygulama ekibi SDK sürümlemeyi ve mağaza incelemesini yönetir.
Otel mobil anahtar teslimiPMS ara katmanından bulut API olaylarıKapılarda kimlik bilgisi hizmeti ve ağ geçidi kapsaması.
Ziyaretçi yönetimi kiosk'uTek kullanımlık kimlik bilgileri için bulut APISaat dilimleri ve sona erme semantiği baştan doğrulanır.
Canlı uzaktan resepsiyonBulut API ile kilit açma ve webhook onayıYalnızca çevrimiçi kilitler uzaktaki komutları anında yürütür.
Çevrimdışı kurumsal cüzdanGüvenli yerel kimlik bilgileriyle mobil SDKCihaz üzerinde anahtar depolama ve iptal kuralları.
Uygulama alanları

Projeler, ürünler ve kanıtlar

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 kilitRezervasyon arka ucu, bulut API üzerinden çevrimdışı ve çevrimiçi şifreler oluşturur.
Ofis cam girişiÇevrimiçi okuyucu veya kontrolörZiyaretç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 kilitPMS 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 kilidiUzaktaki komutlar doğrulanmış bağlantı ve yedek iletişim yöntemleri gerektirir.
Donanım odasıUzaktan yönetilen pil kilidiWebhook denetimleri, operatör uygulamasında faturalama ve kötüye kullanım incelemesini destekler.
Belge paketi

Entegrasyon durum tespiti paketi

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şenTipik mantıkNotlar
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 paketiDesteklenen 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 modeliBelirteç 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 kotalarHı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ğuOlay türleri, veri yükleri, sıralama ve yeniden teslim garantileri.Denetim ve bildirim özellikleri güvenilir olaylara bağlıdır.
Entegrasyon iş akışı

Bir entegrasyon projesini beş adımda yürütmek

  1. Kimlik bilgisi modelini tanımlayınKodları, e anahtarlarını veya kartları kimin alacağını ve bunların nasıl sona ereceğini belirleyin.
  2. Belgeleri ve sandbox'ı edininAPI referansını, kapsamları ve SDK örnek uygulamalarını baştan inceleyin.
  3. Test cihazlarına karşı geliştirinGenel pazarlama iddiaları yerine belirli kilit modellerine karşı geliştirin.
  4. Hata yollarını test edinÇevrimdışı kilitleri, yinelenen webhook'ları, belirteç sona ermesini ve hız sınırlarını simüle edin.
  5. Önce pilot, sonra ölçeklendirinFilo genelinde yayından önce tek bir bina veya otel katı üzerinde test yapın.
SSS

Akıllı kilit API'leri ve SDK'ları hakkında sorular

Akıllı kilit API'si ile SDK arasındaki fark nedir?

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.

Rezervasyon platformumuz her rezervasyon için otomatik olarak kod gönderebilir mi?

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.

Bir uygulamanın API üzerinden kapıları uzaktan açması güvenli mi?

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 her kapı olayının ulaştığını garanti eder mi?

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'yi kim kullanabilir: marka, üretici mi yoksa son müşteri mi?

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.

Akıllı kilit donanımı için yazılım geliştiriyor musunuz?

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

Sepetiniz
Bu siteyi kullanırkenizin deneyimini çerezlere izin vererek iyileştirebilirsiniz. Çerez Politikası
Chat on WhatsApp