BAS-IP Link API: Kapı Giriş ve Erişim Kontrol Sistemleri Nasıl Entegre Edilir?
Yeni bir sakin, yönetim ekibinin daireler, sakinler ve iletişim bilgileri için halihazırda kullandığı sistemde ilk olarak ayarlanır. Daha sonra aynı kişi, bu kez kapı giriş (geçiş kontrol) sisteminde tekrar oluşturulur. Erişim hakları değişir — iki sistemin güncellenmesi gerekir. Sakin taşınır — kaydın iki kez silinmesi gerekir.
Tek bir tesiste, bu sadece ekstra bir idari iştir. Düzenli taşınmalar, erişim değişiklikleri ve geçici geçiş kartları içeren bir gayrimenkul portföyü genelinde, en başından beri kimsenin gerçekten istemediği ayrı bir yönetim süreci haline gelir.
BAS-IP Link ve Link API nedir?
BAS-IP Link, tesisleri, kullanıcıları, erişim haklarını ve bağlı altyapıyı yönetmek için BAS-IP’nin merkezi platformudur.
BAS-IP Link API, üçüncü taraf bir sunucu tarafı sistemin Link ile programatik olarak etkileşime girmesine olanak tanıyan bir HTTP REST API’dir: kullanıcı verilerini aktarır, erişim haklarını ve kimlik bilgilerini yönetir ve platformdan veri alır.
Amaç, personele çalışması için başka bir sistem vermek değildir. Tam aksine: müşterinin mevcut platformu ana işletim arayüzü olarak kalabilir, BAS-IP ise halihazırda orada yönetilen süreçlerin bir parçası haline gelir.
Bu pratikte nasıl görünüyor? Yeni bir sakin eklemek
Yönetim şirketi sakinin adını, dairesini, iletişim bilgilerini ve diğer ilgili bilgileri zaten biliyordur. Bu veriler zaten kendi sistemlerinde mevcuttur.
Bir entegrasyon olmadan, bir personelin BAS-IP Link’i açması ve aynı kullanıcıyı tekrar oluşturması gerekir.
Link API ile bu ikinci adım otomatikleştirilebilir. Ana sistem gerekli verileri Link’e aktarır, kullanıcı uygun tesise ve daireye yerleştirilir ve ardından BAS-IP Link bağlı kapı giriş ve geçiş kontrol altyapısıyla çalışır.
Bunun pratik değeri sadece iki sistemin veri alışverişinde bulunabilmesi değildir. Personelin halihazırda çalıştıkları yöntemi değiştirmek zorunda kalmamasıdır.
Taşınmalar, sakin bilgilerindeki değişiklikler ve ayrılmalar zaten ana platformda yönetiliyorsa, aynı işlemlerin kapı giriş sisteminde manuel olarak tekrarlanmasına gerek yoktur.
BAS-IP cihazlarının kendi API’si varken neden Link API kullanılmalı?
BAS-IP, BAS-IP Device API aracılığıyla ekipmanla doğrudan entegrasyonu da destekler.
Yerel bir proje için bu doğru yaklaşım olabilir. Bir sistemin bir veya daha fazla bilinen cihaz modeliyle çalışması gerekiyorsa ve yalnızca sınırlı bir işlev setine ihtiyaç duyuyorsa, ek bir sunucu katmanı gerekli olmayabilir.
Proje ölçeklendikçe gereksinimler değişir.
Farklı binalar farklı zil panelleri, iç monitörler ve diğer cihazları kullanabilir. Zaman içinde yeni modeller ve donanım yazılımı (firmware) sürümleri piyasaya sürülür. Doğrudan cihaz entegrasyonunda, üçüncü taraf geliştirme ekibinin entegre olduğu ekipmanın özelliklerini hesaba katması gerekir.
BAS-IP Link, üçüncü taraf platformu ile kapı giriş altyapısı arasına merkezi bir yazılım katmanı ekler.
İş mantığını belirli bir zil paneli etrafında oluşturmak yerine, harici platform Link’in merkezi kullanıcı, tesis, daire, erişim hakkı ve diğer varlıklar modeliyle çalışır.
Bu, bir konut mülk yönetim platformu için genellikle daha doğal bir modeldir. Genellikle belirli bir kapıya tam olarak hangi zil panelinin takıldığını bilmesine gerek yoktur. Belirli bir sakinin belirli bir daireye ait olduğunu ve uygun alanlara erişimi olması gerektiğini bilmesi gerekir.
BAS-IP Link, bu iş mantığını fiziksel kapı giriş ve geçiş kontrol altyapısına bağlar.
BAS-IP Link API aracılığıyla neler yapabilirsiniz?
Belirli bir entegrasyon normalde Link’te bulunan işlevlerin yalnızca bir kısmını kullanacaktır.
API aracılığıyla üçüncü taraf bir sistem şunlarla çalışabilir:
- kullanıcılar ve tesis yapısı;
- erişim hakları;
- kartlar, anahtarlıklar, PIN kodları, QR kodları, Face ID, UKEY ve araç plakaları dahil olmak üzere kalıcı ve geçici erişim kimlik bilgileri;
- misafir erişimi ve ziyaretçiler;
- mesajlar ve anketler;
- sanal numaralar ve çağrı yönlendirme;
- uzaktan cihaz yapılandırması;
- olaylar ve günlükler (logs).
Bununla birlikte, bir entegrasyon projesi genellikle “Hangi API yöntemleri mevcuttur?” sorusundan ziyade farklı bir soruyla daha iyi tanımlanır.
Bugün hangi görevler manuel olarak yürütülmektedir ve sistemler entegre edildikten sonra hangileri otomatik olarak gerçekleşmelidir?
Bir platform için birincil kullanım senaryosu sakin yönetimi olabilir. Bir diğeri için geçici yüklenici erişimi olabilir. Üçüncüsü temel olarak olay verilerine ihtiyaç duyabilir.
Sadece kullanıcı oluşturmayı değil, tüm kullanıcı yaşam döngüsünü yönetmek
Kullanıcı oluşturmak sadece ilk adımdır.
Bir sakin eklendikten sonra uygun erişim hakları ve kimlik bilgileri atanabilir. Sakin başka bir daireye taşınırsa, aracını değiştirirse, ek izinler alırsa veya erişimini kaybederse, bu değişiklikler de ana platformdaki iş akışının bir parçası olabilir.
Aynı prensip geçici kullanıcılar için de geçerlidir.
Mevcut bir sistem zaten ziyaretçileri, yüklenicileri veya servis personelini yönetiyorsa, tamamen BAS-IP için ayrı bir idari süreç oluşturmaya gerek yoktur.
Örneğin, ana platform bir yüklenicinin bir binaya Salı günü 10:00 ile 14:00 saatleri arasında girebileceğini belirleyebilir. Bu senaryoda BAS-IP, başka bir yerde zaten tanımlanmış bir süreci yürüten erişim katmanı haline gelir.
Kapı girişi ve geçiş kontrolü böylece bağımsız olarak yönetilmesi gereken ayrı bir sistem olmak yerine, binanın daha geniş işletim modelinin bir parçası haline gelir.
Tesis zaten aktifse ve büyük bir kullanıcı tabanına sahipse ne olur?
Bir entegrasyonun illa ki boş bir veritabanıyla başlaması gerekmez.
Mevcut bir sistem zaten yüzlerce veya binlerce sakin içeriyorsa, bunların BAS-IP Link’e teker teker manuel olarak girilmesine gerek yoktur.
BAS-IP Link API kullanıldığında, kullanıcı oluşturma yöntemi tek bir istekte birden fazla kullanıcı ekleyebilir.
İşlem başına garanti edilen maksimum kayıt sayısı ve ardışık isteklerin izin verilen sıklığı şu anda belirtilmemiştir. Bu nedenle, büyük bir taşıma (migration) için tüm kullanıcı tabanını taşımadan önce bu parametreler projenin test ortamında doğrulanmalıdır.
API yöntemi için uygulama ayrıntıları, teknik dokümantasyonda entegrasyon ortaklarına sağlanmaktadır.
Ayrıca, bir API entegrasyonu geliştirmeden toplu kullanıcı oluşturmak için yerleşik bir seçenek de vardır.
BAS-IP Link, tesis yapısını bir XLS dosyasına aktarabilir. Kullanıcı ve lisans ayrıntıları daha sonra elektronik tabloda tamamlanır ve tekrar Link’e aktarılır. İçe aktarıldıktan sonra, kullanıcılar belirtilen tesis gruplarına otomatik olarak atanır. Birden fazla kullanıcının aynı daireye veya başka bir tesis grubuna ait olduğu durumlarda, ayrı satırlar aynı grup tanımlayıcısını kullanabilir.
İlk konut kurulumu (rollout) için hane halkının her üyesinin e-posta adresini toplamak gerekli değildir. Daire başına bir e-posta adresi yeterlidir: davet edilen kullanıcı bir e-posta alır, kaydı tamamlar ve ardından aile üyelerini kendisi ekleyebilir.
Bu nedenle, mevcut bir geliştirme için proje ekibi, sistem mimarisine ve kaynak kullanıcı veritabanının nerede tutulduğuna bağlı olarak otomatik bir API taşıması ile Link’in yerleşik toplu yükleme işlemi arasında seçim yapabilir.
BAS-IP olayları başka bir sistemde kullanılabilir mi?
Evet. Link’te tutulan veriler ve olaylar üçüncü taraf bir sistem tarafından kullanılabilir.
Örneğin, bir güvenlik ekibi geçiş kontrol, CCTV ve diğer bina sistemlerinden gelen bilgileri bir araya getiren tek bir arayüz üzerinden çalışıyor olabilir. BAS-IP verileri de aynı operasyonel iş akışının bir parçasını oluşturabilir.
Ancak önemli bir teknik fark vardır.
BAS-IP Link şu anda olayları üçüncü taraf sistemlere iletmek (push) için webhooks sağlamamaktadır. Harici sistem, Link API’sine istekte bulunarak gerekli verileri alır.
Bir proje, belirli olayların webhooks aracılığıyla doğrudan ekipmandan iletilmesini gerektiriyorsa, bu senaryo BAS-IP Device API aracılığıyla desteklenen Android tabanlı zil panellerinde mevcuttur.
Dolayısıyla bir proje, Link üzerinden merkezi entegrasyonu gerektiğinde seçilen cihazlarla doğrudan etkileşimle birleştirebilir.
Hangi sistem doğruluk kaynağı (source of truth) olmalıdır?
Bir entegrasyondaki temel kararlardan biri, her veri türünden hangi sistemin sorumlu olduğudur.
Aynı kullanıcı hem mülk yönetim platformunda hem de BAS-IP Link’te bağımsız olarak değiştirilebilirse, kayıtlar sonunda tutarsız hale gelebilir.
Örneğin, mülk yönetim platformu sakinlerden ve dairelerden sorumlu kalabilir, BAS-IP Link bu bilgileri kapı girişine ve geçiş kontrole uygulayabilir, ayrı bir güvenlik platformu ise operatörlerin ihtiyaç duyduğu olay verilerini tüketebilir.
Başka bir proje, sorumlulukları farklı şekilde bölebilir.
Önemli olan BAS-IP’nin veya üçüncü taraf platformunun her zaman “ana” (master) sistem olması gerektiği değildir. Her bir varlık için yetkili kaynağın ve senkronizasyon yönünün açıkça tanımlanması gerektiğidir.
Sadece iki veritabanını birbirine bağlamak yerine mükerrer yönetimi ortadan kaldıran şey budur.
Link API en çok nerede faydalıdır?
Link API, özellikle BAS-IP’nin mevcut bir yazılım ekosisteminin parçası haline gelmesinin gerektiği durumlarda geçerlidir.
Tipik örnekler şunları içerir:
- konut mülkiyeti ve site yönetim platformları;
- büyük geçiş kontrol sistemleri;
- BMS ve akıllı bina platformları;
- PropTech (Gayrimenkul Teknolojisi) ürünleri;
- entegratörlerin kendi yazılım platformları;
- birden fazla binayı veya tesisi yöneten platformlar.
Bir projenin ne kadar çok kullanıcısı, binası ve düzenli erişim değişikliği varsa, sistemler ayrı kaldığında yönetim o kadar çok kopyalanır.
Bu nedenle Link API’nin değeri genellikle mevcut API yöntemlerinin sayısıyla değil, bir araya getirilebilen ayrı operasyonel süreçlerin sayısıyla tanımlanır.
Güvenlik ve entegrasyon izinleri
Üçüncü taraf bir sistemin Link’e kısıtlamasız idari erişimine ihtiyacı yoktur.
BAS-IP Link Self-Hosted’da özel bir entegrasyon hesabı oluşturulabilir ve izinleri hem işlev hem de bireysel tesis bazında kısıtlanabilir.
Örneğin, belirli bir mülk operatörü tarafından kullanılan bir entegrasyon, o kuruluş tarafından yönetilen binalarla sınırlandırılabilir.
Kimlik doğrulama için erişim belirteçleri (access tokens) kullanılır ve API iletişimi HTTPS üzerinden gerçekleşir.
Ayrıntılı kimlik doğrulama akışı ve istek yapıları, Link API teknik dokümantasyonunda ele alınmaktadır.
BAS-IP Link Self-Hosted ve Link Cloud
Yayın tarihinde, BAS-IP Link API aracılığıyla üçüncü taraf sunucu tarafı entegrasyonları BAS-IP Link Self-Hosted’da desteklenmektedir.
BAS-IP, BAS-IP Link Cloud için ayrı bir API ağ geçidi (API gateway) geliştirmektedir.
Bir proje özellikle Link Cloud ile üçüncü taraf entegrasyonu gerektiriyorsa, önerilen mimari geliştirme başlamadan önce BAS-IP ile görüşülmelidir.
Entegrasyon nasıl başlatılır
Bir Link API projesi, API çağrılarının listesinden ziyade kullanım senaryosuyla (use case) başlar.
Örneğin:
“Platformumuzda bir sakin oluşturduğumuzda, kullanıcının otomatik olarak doğru BAS-IP tesisinde oluşturulmasını istiyoruz.”
Bu mimari bir tartışma başlatmak için yeterlidir.
Entegrasyon senaryosu üzerinde anlaşıldıktan sonra ortak bir NDA (Gizlilik Sözleşmesi) imzalar ve ilgili teknik materyalleri alır.
Entegrasyonun kendisi normalde ortağın ekibi tarafından geliştirilir. Tipik bir proje genellikle bir back-end veya full-stack geliştirici gerektirecektir. Daha büyük kurulumlar (deployments) DevOps uzmanlığı da gerektirebilir.
Geliştirme ve test için BAS-IP Link Self-Hosted, ortağın kendi ortamına kurulabilir. Şu anda Link API için paylaşılan ortak bir test ortamı (sandbox) bulunmamaktadır. Test lisansı ve donanım düzenlemeleri, ilgili projenin gereksinimlerine göre kararlaştırılır.
BAS-IP dokümantasyon sağlar, kendi ürünleriyle ilgili teknik soruları yanıtlar ve dokümantasyona dayalı bir uygulamanın beklendiği gibi davranmadığı durumları araştırmaya yardımcı olur.
Bir proje şu anda üründe bulunmayan bir işlevsellik gerektiriyorsa, bu gereksinim ürün ekibiyle tartışılabilir. İlgili çalışma ve bunun geliştirme planındaki yeri ilk olarak değerlendirilir. Böyle bir değerlendirme, kendi başına belirli bir sürüm tarihi için bir taahhüt teşkil etmez.
Bir Link API entegrasyonu ne kadar sürer?
Her proje için geçerli olan tek bir zaman çizelgesi yoktur.
Nispeten standart bir entegrasyon için takvim süresi genellikle daha uzun olsa da genel bir rehber olarak yaklaşık bir aylık odaklanmış bir geliştirme süreci kullanılabilir.
Ortağın geliştirme ekibinin Link veri modelini anlaması, entegrasyonun kendi kısmını uygulaması, test etmesi ve çalışmayı kendi geliştirme programına sığdırması için zamana ihtiyacı vardır.
Bu nedenle, anlamlı bir tahmin ancak gerçek entegrasyon senaryosu tanımlandıktan sonra yapılabilir.
BAS-IP Link API için ek bir ücret var mı?
BAS-IP normalde dokümantasyona ve entegrasyon araçlarına erişim için ayrı bir ücret talep etmez.
BAS-IP Link’in kendisi standart ürün lisanslama modeli altında lisanslanmıştır. Ortak entegrasyonun kendi tarafını geliştirirken, standart dışı BAS-IP geliştirme çalışmaları veya bu tür çalışmaların önceliğini değiştirme talepleri gerektiğinde ayrı olarak tartışılabilir.
Bu nedenle, entegrasyonun kendisini “ücretsiz” olarak tanımlamak yanıltıcı olabilir.
Daha doğru bir ifade, BAS-IP entegrasyon araçlarına erişim için normalde ayrı bir ücret alınmadığıdır.
Link API ne zaman doğru bir yaklaşım değildir?
Link API öncelikle BAS-IP Link ile sunucu tarafı entegrasyonu için tasarlanmıştır.
Gereksinim, belirli bir ekipmanla doğrudan çalışmak veya belirli olayları doğrudan bir zil panelinden almaksa, BAS-IP Device API daha uygun olabilir. Cihaz entegrasyonu dokümantasyonu, genel BAS-IP geliştirici portalı üzerinden mevcuttur.
Bir kuruluşun zaten kendi mobil uygulaması varsa ve bu uygulamanın içine kapı aramaları, video ve kapı açma (kilit açma) eklemek istiyorsa, BAS-IP Mobile SDK bu kullanım durumu için tasarlanmıştır.
Ve SIP, RTSP veya Wiegand aracılığıyla standart birlikte çalışabilirliğin (interoperability) yeterli olduğu durumlarda, özel bir yazılım entegrasyonuna hiç gerek olmayabilir.
Farklı yaklaşımlar, “BAS-IP IP Kapı Giriş Sistemlerini Mevcut Bina Sistemleriyle Entegre Etmek” bölümünde daha ayrıntılı olarak ele alınmaktadır.
Sıkça sorulan sorular
BAS-IP Link API bir REST API midir?
Evet. BAS-IP Link API, üçüncü taraf bir sunucu tarafı sistemin BAS-IP Link ile programatik olarak etkileşime girmesini sağlayan bir HTTP REST API’dir.
Link API’yi kullanmak için BAS-IP Link’e ihtiyacım var mı?
Evet. Link API, BAS-IP Link platformunun programlama arayüzüdür.
BAS-IP Link API, Link Cloud ile çalışır mı?
Yayın tarihinde, Link API aracılığıyla üçüncü taraf sunucu tarafı entegrasyonları BAS-IP Link Self-Hosted’da desteklenmektedir. BAS-IP, Link Cloud için ayrı bir API ağ geçidi geliştirmektedir.
Dokümantasyonu nasıl edinebilirim ve NDA gerekli midir?
İlk olarak entegrasyon kullanım senaryosu (use case) üzerinde anlaşılır. Ardından ortak bir NDA imzalar ve Link API ile ilgili teknik materyalleri alır.
Link API ile Mobile SDK arasındaki fark nedir?
Link API; kullanıcılar, tesisler, erişim hakları ve diğer merkezi platform varlıkları dahil olmak üzere BAS-IP Link ile sunucu tarafı entegrasyonu için tasarlanmıştır.
BAS-IP Mobile SDK ise farklı bir amaca hizmet eder: kapı girişi (interkom) işlevselliğini doğrudan mevcut bir mobil uygulamaya eklemek.
Gerektiğinde aynı projede her ikisi de kullanılabilir.
Platformunuzu BAS-IP Link ile entegre etmek ister misiniz?
İlk görüşmeden önce ayrıntılı bir API spesifikasyonu hazırlamanıza gerek yoktur.
Sahip olduğunuz sistemi ve otomatikleştirmek istediğiniz süreci anlatarak başlayın.
Örneğin:
“Sakinleri kendi platformumuzda oluşturuyoruz ve otomatik olarak BAS-IP’ye aktarılmalarını istiyoruz.”
veya:
“Ziyaretçi erişimini kendi sistemimizde yönetiyoruz ve bu süreci BAS-IP ile bağlamak istiyoruz.”
BAS-IP ekibi; Link API’nin doğru yaklaşım olup olmadığını, hangi platform özelliklerinin gerekli olacağını ve entegrasyonun nasıl yapılandırılması gerektiğini belirlemeye yardımcı olabilir.