In einem Gebäude arbeitet die Verwaltungsgesellschaft in einer Immobilienverwaltungsplattform, der Sicherheitsdienst in einem Zutrittskontrollsystem (ZKS) und die Bewohner in einer separaten mobilen App. Bleibt die Türsprechanlage ein weiteres isoliertes System, müssen dieselben Benutzer, Zugriffsrechte und Ereignisse an mehreren Orten gleichzeitig verwaltet werden.

BAS-IP kann in die bereits genutzte digitale Gebäudeinfrastruktur integriert werden. Die Verwaltungsplattform bleibt die primäre Arbeitsumgebung für das Personal, und die bestehende App für die Bewohner erhält Funktionen für die Türsprechanlage und die Türöffnung.

Es gibt vier Wege, dies zu erreichen: Kompatibilität über Standardprotokolle, BAS-IP Link API, BAS-IP Mobile SDK und BAS-IP Device API. Nachfolgend finden Sie eine Übersicht, was sich für welche Aufgabe eignet.

Was ist BAS-IP Link

BAS-IP Link ist eine Softwareplattform, die verbundene BAS-IP-Geräte, Gebäude und Wohnungen, Benutzer, Zugangskennungen, Anrufe und die Gerätekonfiguration verwaltet.

Sie ist in zwei Varianten verfügbar: Link Self-Hosted auf dem Server des Kunden und Link Cloud als BAS-IP-Cloud-Dienst.

Kompatibilität über Standardprotokolle

Nicht für jede Aufgabe werden Entwickler benötigt. BAS-IP-Geräte arbeiten mit denselben Standardprotokollen wie Telefonie, Videoüberwachung und Zutrittskontrollsysteme:

• SIP — das Panel registriert sich als SIP-Client an der Telefonanlage des Kunden, und Anrufe gehen an vorhandene Telefone und Softphones;
• RTSP — das Panel verbindet sich mit dem VMS oder NVR als Videoquelle zusammen mit den anderen Kameras des Objekts;
• Wiegand — der Leser des Panels überträgt die Kennung an ein ZKS eines Drittanbieters.

Solche Szenarien werden auf beiden Seiten konfiguriert und erfordern keine Arbeit mit der BAS-IP API oder dem SDK.

Hinweis: Für das SIP-Szenario muss vorab die Kompatibilität der Audio- und Video-Codecs des Drittsystems mit der jeweiligen BAS-IP-Hardware geprüft werden. Beispielsweise unterstützt die BAS-IP-Hardware Szenarien mit PCMA für Audio und H.264 für Video. Die aktuellen Codecs müssen für das spezifische Modell und die Firmware-Version überprüft werden.

Standardprotokolle ermöglichen die Übertragung von Anrufen, Videostreams und Kennungen, sorgen aber allein nicht für die Synchronisierung von Benutzern, Wohnungen und Zugriffsrechten zwischen den Systemen.

Wenn es erforderlich ist, die Benutzerverwaltung, die Vergabe und den Entzug von Zugriffsrechten oder die Arbeit mit Ereignisprotokollen zu automatisieren, werden APIs oder SDKs verwendet.

BAS-IP Link API: Integration mit einer Verwaltungs- oder Serverplattform

Die Link API ermöglicht es, die Verwaltung von Bewohnern, Zugriffsrechten und BAS-IP-Ereignissen über die bereits genutzte Immobilienverwaltungsplattform, ZKS oder ein anderes Unternehmenssystem zu automatisieren.

Ein einfaches Beispiel ist der Einzug eines Bewohners.

Ein Mitarbeiter legt ein Profil in seiner Plattform an: Name, Wohnung und Kontaktdaten. Ohne Integration wird derselbe Benutzer manuell ein zweites Mal im Türsprechanlagensystem angelegt.

Über die Link API werden die Daten automatisch übertragen: Der Benutzer erscheint im richtigen Gebäude und der richtigen Wohnung in BAS-IP Link, und von dort werden die Informationen auf die verbundene BAS-IP-Infrastruktur angewendet.

Dies ist nur eines der Szenarien.

Über die Link API kann ein Drittsystem arbeiten mit:

• Benutzern und der Struktur von Objekten;
• Zugriffsrechten;
• permanenten Kennungen: Karten, Schlüsselanhänger, Codes, QR-Codes, Face ID, UKEY und Kfz-Kennzeichen;
• temporären Kennungen mit begrenzter Gültigkeitsdauer;
• Gastzugang und Besuchern;
• Nachrichten an Bewohner;
• virtuellen Nummern und Anrufweiterleitung;
• Fernkonfiguration von Geräten;
• Ereignissen und Protokollen.

Der spezifische Umfang hängt von der Aufgabe ab.

Bei diesem Schema kann die Hauptplattform des Kunden die Arbeitsoberfläche der Mitarbeiter bleiben.

Derzeit werden Server-Integrationen von Drittanbietern über die Link API in BAS-IP Link Self-Hosted unterstützt. Für Projekte in der Link Cloud müssen die verfügbaren Integrationsoptionen mit BAS-IP abgestimmt werden.

BAS-IP Mobile SDK: Türsprechanlage in der eigenen App

Das zweite Szenario — das Unternehmen hat bereits eine mobile App für Bewohner, Mieter oder Mitarbeiter.

Sie kann Anfragen an die Hausverwaltung, Zahlungen, Raumbuchungen und Benachrichtigungen umfassen. Eine separate App nur für die Türsprechanlage könnte in dieser Situation überflüssig sein.

Das BAS-IP Mobile SDK ermöglicht es, umfangreiche Türsprech- und Zutrittskontrollfunktionen über BAS-IP Link in eine bestehende App zu integrieren. Zu den verfügbaren Optionen gehören:

• Benutzerautorisierung;
• Empfangen und Tätigen von Audio- und Videoanrufen;
• Anzeigen des Videos vom Panel vor der Annahme des Anrufs;
• Push-Benachrichtigungen;
• Türöffnung;
• Anrufhistorie;
• mobiler Zugriff über BLE über die UKEY-Komponente;
• Aufzugruf in die berechtigte Etage, sofern ein BAS-IP-Aufzugsmodul konfiguriert ist.

iOS und Android werden unterstützt.

Der Bewohner empfängt den Anruf vom Panel direkt in der App, die er bereits nutzt, kann den Besucher noch vor der Annahme sehen und die Tür öffnen.

Der Entwickler muss das Türsprechmodul nicht von Grund auf neu erstellen: Die Details der SIP-Kommunikation und der Interaktion mit BAS-IP Link sind bereits in fertigen Komponenten implementiert, und die Aufgabe des Partnerteams besteht darin, diese in seine App zu integrieren.

Das Mobile SDK wiederholt nicht die gesamte Funktionalität der BAS-IP Link-App, sondern bietet eine bestimmte Reihe vorgefertigter Funktionen.

Einige Funktionen, die im Mobile SDK fehlen, sind über die BAS-IP Link API verfügbar. Zum Beispiel kann die Erstellung von Gäste-QR-Codes und die Raumbuchung in der App des Partners durch zusätzliche Integration mit der Link API realisiert werden.

Die Integration von mobilen Apps von Drittanbietern über das Mobile SDK wird derzeit in BAS-IP Link Self-Hosted unterstützt.

BAS-IP Device API: Direkte Arbeit mit der Hardware

Nicht jede Integration erfordert BAS-IP Link.

Türstationen, Innenmonitore und andere unterstützte BAS-IP-Geräte, einschließlich des Aufzugsmoduls, verfügen über eine eigene lokale API, sodass ein Drittsystem direkt auf die Hardware zugreifen kann.

Der Unterschied ist einfach:

• Device API verbindet Ihr System direkt mit bestimmten BAS-IP-Geräten.
• Link API verbindet Ihr System mit BAS-IP Link, das bereits die angeschlossenen Geräte verwaltet.

Die direkte Arbeit mit den Geräten eignet sich für ein lokales Projekt mit einer begrenzten und im Voraus bekannten Auswahl an Modellen.

Die Integration über Link ist bequemer, wenn das System verschiedene Modelle, eine große Anzahl von Geräten oder mehrere Gebäude umfasst: Link reduziert die Abhängigkeit der Integration von den Besonderheiten einzelner Modelle und deren Firmwares.

Der Zugang zur Device API ist einfacher zu erhalten: Die Dokumentation ist offen, ein NDA ist nicht erforderlich. Es reicht aus, sich im BAS-IP-Entwicklerportal — developers.bas-ip.com — zu registrieren und die E-Mail-Adresse zu bestätigen.

Webhooks

Android-Panels von BAS-IP unterstützen zusätzlich Webhooks.

Das externe System empfängt Ereignisse in dem Moment, in dem sie eintreten: Türöffnung, Gewährung oder Verweigerung des Zugangs, Geräteupdate und andere Protokollereignisse.

Dies ist praktisch für Smart-Building-Szenarien, bei denen ein anderes System auf den Durchgang oder das Öffnen einer Tür reagieren soll.

Webhooks werden direkt am Panel über die Gerätekonfiguration eingerichtet.

Auf Linux-Panels, Monitoren und auf der Ebene von BAS-IP Link werden Webhooks nicht unterstützt.

Welche Integrationsmethode soll ich wählen

Es ist nicht zwingend erforderlich, den Ansatz im Voraus festzulegen. Meistens wird es klar, nachdem das bestehende System und das gewünschte Szenario beschrieben wurden.

Was das im Gebäude bringt

• Schnellere Ersteinrichtung: Benutzerdaten und zugehörige Parameter können aus dem System übertragen werden, in dem sie bereits gepflegt werden.
• Weniger doppelte Eingaben: Dieselben Daten müssen nicht in mehrere Schnittstellen eingegeben werden.
• Gemeinsame Objektdaten: Ereignisse der Türsprechanlage und des Zugangs können zusammen mit den übrigen Informationen gesammelt werden.
• Gewohnte Arbeitsprozesse: Das Personal arbeitet weiterhin im vertrauten System, und die Bewohner in einer einzigen App.

Je größer das Gebäude, die Benutzerzahl und die angebundenen Systeme, desto spürbarer ist der Effekt.

Wie die Integration abläuft

Die Arbeit beginnt mit der Besprechung der Aufgabe. Der Partner erklärt, welches System er verwendet und was er umsetzen möchte. Beispielsweise Anrufe von BAS-IP-Türsprechanlagen in der eigenen App für Bewohner entgegennehmen oder Daten neuer Benutzer aus der Immobilienverwaltungsplattform automatisch übertragen. Basierend auf diesen Anforderungen hilft BAS-IP bei der Auswahl der geeigneten Integrationsmethode und stimmt ab, wie die fertige Lösung funktionieren soll.

Wenn das Szenario festgelegt ist, erhält das Partnerteam die erforderlichen technischen Materialien und kann mit der Entwicklung beginnen. Für die Arbeit mit Link API und Mobile SDK wird vorab ein NDA unterzeichnet, während die Dokumentation zur Device API offen zugänglich ist. Die Bedingungen für die Bereitstellung der Testumgebung, der Lizenzen und der Ausrüstung werden unter Berücksichtigung der Besonderheiten des Projekts besprochen.

Die Integration selbst wird vom Partnerteam entwickelt, während die BAS-IP-Spezialisten zur Arbeit ihrer Produkte beraten und bei technischen Fragen helfen. Wenn die vorhandenen BAS-IP-Funktionen für das gewünschte Szenario nicht ausreichen, kann eine zusätzliche Entwicklung besprochen werden. Die Fristen für solche Anpassungen hängen vom Arbeitsumfang und den aktuellen Prioritäten des Produktteams ab.

Nach Abschluss der Entwicklung testet der Partner die Integration in seiner Umgebung und demonstriert das Ergebnis anschließend BAS-IP oder stellt eine Beschreibung der implementierten Lösung zur Verfügung.

Die Dauer der Integration hängt von der Komplexität des Projekts, der Architektur des Drittsystems und der Auslastung des Entwicklerteams ab. Der Zeitplan wird auch von der Vorbereitung der Entwicklungsumgebung und den Tests beeinflusst.

Wie viel das kostet

BAS-IP erhebt standardmäßig keine separaten Gebühren für den Zugriff auf die Dokumentation und die Integrationstools.

Die Lizenzierung der BAS-IP-Produkte erfolgt zu regulären Bedingungen, und zusätzliche Anpassungen oder Prioritätsänderungen werden separat vereinbart.

Häufige Fragen

Was ist der Unterschied zwischen Link API und Mobile SDK?

Die Link API verbindet BAS-IP mit einem Serversystem — z. B. einer Immobilienverwaltungsplattform oder einem ZKS. Das Mobile SDK fügt einer mobilen App Türsprechfunktionen hinzu. In einem Projekt können beide zusammen genutzt werden.

Ist BAS-IP Link für die Integration erforderlich?

Nicht immer. Viele BAS-IP-Geräte haben eine eigene lokale API, sodass ein Drittsystem direkt mit der Hardware arbeiten kann. Link ist in der Regel bequemer, wenn die Integration verschiedene Modelle, viele Geräte oder mehrere Objekte umfasst.

Ist ein NDA erforderlich?

Ein NDA ist für Link API und Mobile SDK erforderlich. Die Dokumentation zur Device API ist offen.

Gibt es Webhooks?

Ja, bei Android-Panels. Das externe System kann Geräteereignisse in Echtzeit empfangen. Auf Linux-Panels, Monitoren und auf Link-Ebene gibt es keine Webhooks.

Kann man eine Drittanbieter-Plattform mit der BAS-IP Link Cloud integrieren?

Externe Integrationen von Drittanbieter-Serversystemen über die Link API werden derzeit auf Link Self-Hosted realisiert. Für Link Cloud befindet sich eine solche Möglichkeit in der Entwicklung.

Möchten Sie BAS-IP in Ihr System integrieren?

Sagen Sie uns, welche Plattform, App oder Hardware Sie verwenden und welches Szenario Sie umsetzen möchten.

Das BAS-IP-Team hilft bei der Auswahl der passenden Option: Protokollkompatibilität, Link API, Mobile SDK, Device API oder eine Kombination daraus.