Geliştirici Kılavuzu: AUSLOCK API / SDK Genel Bakış (TTLock Ekosistemi)
AUSLOCK uygulaması, bulut erişimi, ağ geçitleri ve geliştirici entegrasyonları için TTLock ekosistemini kullanır. Bu sayfa, resmi kaynaklara ve geliştiricilerin kilitleri yazılım platformlarına entegre ederken kullandıkları en yaygın kalıplara ilişkin pratik bir genel bakış sunmaktadır.
Açık API belgeleri:
TTLock Açık API Dokümantasyonu
Örnek uç nokta (Kilidi Aç):
Uç Noktanın Kilidini Açma (v3)
iOS SDK talimatları:
iOS SDK
Android SDK talimatları:
Android SDK
Neler inşa edebilirsiniz?
- Mülk/rezervasyon otomasyonu: Zamanlanmış kodlar oluşturun ve rezervasyon aralıklarına göre erişimi yönetin.
- Erişim yönetimi: personel kodları, zaman çizelgeleri, rol tabanlı erişim
- Operasyon panoları: kapı durumu, denetim kayıtları (cihaza ve entegrasyon katmanına göre değişiklik gösterir)
- Özel uygulamalar: Saha içi Bluetooth iş akışları için iOS/Android SDK kullanan mobil uygulamalar.
Temel kavramlar (ekosistemin nasıl bir araya geldiği)
- Kilit (cihaz): kapı donanımı
- Ağ Geçidi/Merkez: Kilidi uzaktan işlemler ve senkronizasyon için internete bağlar (bulut otomasyonu için önerilir)
- Bulut API'si: Otomasyon katmanları ve platformları için sunucudan sunucuya entegrasyon.
- Mobil SDK'lar: iOS/Android için uygulama tarafı entegrasyonu (Bluetooth + cihaz iş akışları)
Ağ geçidi notu (uzaktan erişim özellikleri için önemlidir)
Birçok uzaktan erişim özelliği (uzaktan kilit açma, planlanmış kodların uzaktan senkronize edilmesi, bazı denetim iş akışları) bir Wi-Fi ağ geçidi/merkezi gerektirir. Ağ geçidi olmadan, cihaz kontrolü Bluetooth menzili ve yerel telefon yakınlığıyla sınırlı olabilir.
Tipik entegrasyon modelleri
A Modeli — PMS / rezervasyon platformu → erişim kodları
- Rezervasyon oluşturuldu/güncellendi
- Sisteminiz bir erişim politikası oluşturur (kod + başlangıç/bitiş zamanı).
- Open API aracılığıyla kilitleme politikasını uygulamaya aktarın.
- Misafiri SMS/e-posta/mesaj şablonu aracılığıyla bilgilendirin.
Desen B — Erişim yönetimi paneli
- Yönetici, sisteminizde kullanıcılar/roller oluşturur.
- Kapıları ve programları atayın
- API aracılığıyla cihazlarla senkronize edin.
- Portalda gösterilen denetim olayları (özellikler kilit + ağ geçidi + yapılandırmaya göre değişiklik gösterir)
C Modeli — Mobil uygulama (Bluetooth öncelikli)
- Yerinde eşleştirme/kontrol için iOS/Android SDK'yı kullanın.
- Kurulum ekipleri veya yerel erişim iş akışları için idealdir.
- Uzaktan otomasyon gerekiyorsa ağ geçidini daha sonra ekleyin.
Güvenlik ve en iyi uygulamalar
- En az ayrıcalık ilkesi: Kişisel yönetici oturum açma bilgisi yerine özel bir entegrasyon hesabı kullanın.
- Token yönetimi: Token'ları sunucu tarafında güvenli bir şekilde saklayın ve güvenliği ihlal edilirse kimlik bilgilerini değiştirin.
- Saat dilimi disiplini: Erişim pencerelerinin kaymasını önlemek için her zaman özellik saat dilimini, sistem saat dilimini ve kilit saat dilimini eşleştirin.
- Test Etme: Tüm portföye yaymadan önce bir test kilidine karşı doğrulama yapın.
Sorun giderme (geliştirici odaklı)
- Uzaktan aramalar başarısız oluyor: Ağ geçidinin çevrimiçi olduğundan ve kilidin bağlı olduğundan emin olun; önce uygulama içinde uzaktan kilit açmayı test edin.
- Zamanlama hatalı: saat dilimini ve cihaz saatini düzeltin; basit bir 1 saatlik zaman aralığıyla yeniden test edin.
- Olaylar/kayıtlar eksik: Kayıt detayları cihaza ve platforma bağlıdır; hedef kilidin neleri desteklediğini doğrulayın.
Yardıma mı ihtiyacınız var? Özel bir entegrasyon oluşturuyorsanız, araçlarımızı kullanın. uyumluluk kontrolü ve şunları içermelidir: kilit modeli + ağ geçidi modeli + kullanım senaryonuz (kodlar, uzaktan kilit açma, denetim kayıtları veya özel uygulama).