
Die Integration von Schlössern in eine App, ein PMS oder eine Gebäudesteuerung erfolgt über zwei unterschiedliche Werkzeuggruppen: Cloud-APIs für Fernzugriffsfunktionen und Bluetooth SDKs für die Steuerung über das Telefon in räumlicher Nähe. Sie miteinander zu verwechseln, ist der häufigste Fehler bei der Integrationsplanung.
Wenn eine Drittanbieter-App intelligente Türschlösser bedienen muss – etwa ein Vermietungskanal, der Codes ausgibt, eine Büroplattform, die Besucher bereitstellt, oder eine Hotel-App, die mobile Schlüssel übermittelt –, stellt der Schlosshersteller programmierbare Schnittstellen in zwei Ebenen bereit. Die Cloud-API ist typischerweise ein REST-artiger Dienst über HTTPS: Die Anwendung authentifiziert sich mit OAuth-artigen Zugangsdaten, erstellt Passcodes oder ekeys, sendet Fernentriegelungsbefehle für online verfügbare Schlösser, fragt den Schlossstatus ab und empfängt Webhook-Rückrufe zu Entriegelungs-, Niedrigbatterie- und Manipulationsereignissen. Das mobile SDK ist eine Bibliothek, die in die eigene iOS- oder Android-App des Integrators eingebettet wird und die Bluetooth-Erkennung, sichere Verbindung, Entriegelung in räumlicher Nähe sowie die Offline-Logik für Zugangsdaten übernimmt, ohne eine Rückfrage an einen Server zu senden. Erfolgreiche Integrationen nutzen beide Ebenen gezielt, schützen ihre Zugangsdaten und testen vor dem Start Ratenbegrenzungen und Ereigniszustellung. Dieser Leitfaden erläutert die maßgeblichen Konzepte und Fragen an den Hersteller. Verfügbarkeit, Berechtigungsbereiche und Lizenzierung von API und SDK für jede Plattform werden je Angebot schriftlich bestätigt.
| Cloud API | HTTPS-Dienste verwalten Schlösser, Zugangsdaten und Ereignisse von einem Server aus; Türen werden nur erreicht, wenn die Schlösser online über Wi-Fi oder ein Gateway verbunden sind. |
| Mobile SDK | In iOS/Android eingebettete Bibliotheken übernehmen die Bluetooth-Verbindung, Entriegelung in räumlicher Nähe und Offline-Logik in der eigenen App des Integrators. |
| Authentifizierung | OAuth-artige Client-Zugangsdaten, Tokens mit Berechtigungsbereich und signierte Webhooks trennen professionelle Plattformen von offenen Relay-Skripten. |
| Zugangsdaten je API | Übliche Vorgänge umfassen das Erstellen befristeter Passcodes, ekeys, Karten und Besucherlinks sowie Endpunkte zum Auflisten, Aktualisieren und Widerrufen. |
| Ereigniszustellung | Webhooks melden Entriegelungen, Codeverwendungen, niedrigen Batteriestand und Türereignisse; Wiederholungsverhalten und Reihenfolgegarantien müssen dokumentiert sein. |
| Hardwareabhängigkeit | Fernbefehle werden nur auf online erreichbaren Schlössern über Wi-Fi oder ein Gateway ausgeführt, daher müssen API-Design und Hardware-Topologie gemeinsam geplant werden. |
| Unsere Vorgehensweise | Wir stellen Schnittstellendokumentation, eine Sandbox oder Testgeräte sowie einen technischen Ansprechpartner bereit; Produktionszugangsdaten und Limits stammen aus der Plattformvereinbarung. |
Serverseitige Automatisierung (Vermietungskanäle, PMS, Besucherverwaltung) baut auf der Cloud API auf; markeninterne Telefon-Apps mit Steuerung in räumlicher Nähe oder offline ergänzen das mobile SDK. Produkte, die beides benötigen, sollten ihr Zugangsdatenmodell vor dem Programmieren festlegen.
| Integrationsziel | Primäre Werkzeuggruppe | Wesentliche Abhängigkeit |
|---|---|---|
| Befristete Mietcodes ausgeben | Cloud API aus dem Buchungs-Backend | Die Schlösser unterstützen den gewünschten Codetyp und den Synchronisierungspfad. |
| Markeninterne Mieter-App | Mobile SDK und Cloud API | Das App-Team übernimmt die SDK-Veröffentlichung und die Prüfung durch den Store. |
| Mobile Hotel-Schlüssel übermitteln | Cloud-API-Ereignisse aus der PMS-Middleware | Abdeckung durch den Zugangsdaten-Dienst und Gateways an den Türen. |
| Kiosk zur Besucherverwaltung | Cloud API für einmalige Zugangsdaten | Zeitzonen und Ablaufsemantik werden frühzeitig validiert. |
| Live-Fern-Concierge | Entriegelung per Cloud API und Webhook-Bestätigung | Nur online erreichbare Schlösser führen Fernbefehle sofort aus. |
| Offline-Unternehmens-Wallet | Mobile SDK mit gesicherten lokalen Zugangsdaten | Regeln für Schlüsselspeicherung und Widerruf auf dem Gerät. |
APIs treffen an der Tür auf die physische Realität: Gateways, Metalltüren und der Batterieeinsatz bestimmen, ob ein sauberer API-Aufruf ein Schloss rechtzeitig erreicht. Testen Sie Hardware und Software gemeinsam.
| Objekt | Typische Tür | Lösungsansatz |
|---|---|---|
| Tür einer Mietwohnung | Bluetooth-Schloss mit Gateway je Bereich | Das Buchungs-Backend erstellt über die Cloud API Offline- und Online-Codes. |
| Glaser Büroeingang | Online-Leser oder Controller | Die Besucherplattform sendet einmalige Zugangsdaten und empfängt Webhooks für Zutrittsereignisse. |
| Hotelzimmer | RFID-Schloss mit Dienst für mobile Schlüssel | Die PMS-Middleware ruft die Schlüssel-API auf; das Gateway übermittelt Aktualisierungen in Echtzeit. |
| Coworking-Tür | Intelligentes Türschloss hinter einer Glasfassade | Die Mitglieder-App bindet das SDK ein, um selbst bei schwachem Wi-Fi in räumlicher Nähe zu entriegeln. |
| Logistiktor | Online-Schloss für den Außenbereich | Fernbefehle erfordern eine bestätigte Verbindung und Ersatzkontakte. |
| Freizeitraum | Fernverwaltetes batteriebetriebenes Schloss | Webhooks prüfen die Nutzung für Abrechnung und Missbrauchsprüfung in der Betreiber-App. |
APIs ähneln sich in Präsentationen, unterscheiden sich jedoch im Produktivbetrieb. Bevor Integratoren Entwicklungskapazität binden, sollten sie die folgenden Unterlagen einholen, deren Koordination mit dem Plattformteam wir unterstützen.
| Komponente | Typische Logik | Hinweise |
|---|---|---|
| API-Referenz | Endpunkte, Berechtigungsbereiche, Versionen und Sandbox-Verfügbarkeit. | Entwicklungsschätzungen setzen vollständige, aktuelle Dokumentation voraus. |
| SDK-Paket | Unterstützte OS-Versionen, Beispiel-Apps und Veröffentlichungsrhythmus. | Store-Genehmigung und Wartungsmodelle müssen verstanden sein. |
| Sicherheitsmodell | Token-Typen, Secret-Rotation, Webhook-Signierung und IP-Optionen. | Der Schutz von Entriegelungsendpunkten ist im Produktivbetrieb unverhandelbar. |
| Limits und Kontingente | Ratenbegrenzungen, Paginierung, Stapelverarbeitung und Wiederholungsregeln. | Andernfalls können Flottenstarts während der Stoßzeiten beim Check-in scheitern. |
| Ereigniskatalog | Ereignistypen, Nutzdaten, Reihenfolge und Zustellgarantien bei erneuter Übermittlung. | Audit- und Benachrichtigungsfunktionen hängen von zuverlässigen Ereignissen ab. |
Eine API ist eine Server-zu-Server-Schnittstelle: Ihr Backend ruft die Schlossplattform über HTTPS auf, um Codes zu erstellen, Entriegelungsbefehle an vernetzte Schlösser zu senden, den Status abzufragen und Webhook-Ereignisse zu empfangen; sie funktioniert unabhängig von der Nähe zum Mobiltelefon. Ein mobiles SDK ist eine Softwarebibliothek, die in Ihre eigene iOS- oder Android-App integriert wird und direkt über Bluetooth mit Schlössern kommuniziert. Dadurch werden Entriegelung in der Nähe, Einrichtung und die Offline-Speicherung von Zugangsdaten ermöglicht, wenn kein Server erreichbar ist. Vermietungs-Backends und PMS-Integrationen benötigen in der Regel die Cloud-API; markenspezifische Mieter-Apps benötigen häufig das SDK plus ausgewählte API-Aufrufe. Alles ausschließlich über die API abzuwickeln – etwa ein ausschließlich über Bluetooth steuerbares Schloss aus der Ferne ohne Gateway zu entriegeln – funktioniert einfach nicht. Daher müssen Hardware-Topologie und Schnittstell gemeinsam konzipiert werden. Die verfügbaren Schnittstellen je Plattform werden schriftlich in jedem Angebot bestätigt.
Ja, das ist ein gängiges Integrationsmuster: Sobald eine Reservierung bestätigt wird, ruft Ihr Backend oder Middleware die Schlossplattform-API mit Raum oder Einheit sowie An- und Abreise auf und erhält einen Passcode oder ekey, der über Ihre eigene Nachrichten- oder E-Mail-Vorlage an den Gast übermittelt wird. Webhooks bestätigen anschließend die Nutzung und melden Ereignisse wie versuchte vorzeitige Check-ins oder niedrige Batteriestände. Festzulegen sind insbesondere die Zeitzonenbehandlung für Datumszeiträume, der für die ausgewählten Schlösser offline funktionierende Codetyp, die Gateway-Abdeckung für eine sofortige Widerrufung, idempotente Wiederholungen bei erneutem Nachrichtenversand sowie die Aktualisierung der Zugangsdaten bei Stornierungen oder Datenänderungen. Wir stellen Testschlösser bereit und unterstützen Integrations-Workshops; Endpunktdetails, Ratenbegrenzungen und Lizenzierung werden für jede Plattform schriftlich in jedem Angebot bestätigt.
Fernentriegelung ist sicher, wenn die Plattform wie jede authentifizierte Finanz-API aufgebaut ist: OAuth-ähnliche Tokens mit eingeschränktem Umfang, serverseitige Speicherung von Geheimnissen, personalisierte Berechtigungen, Befehlsbestätigung per Webhook, Prüfprotokolle und optional eine Zwei-Faktor-Genehmigung für besonders sensible Türen. Gefährlich wird es, wenn Integratoren langlebige Geheimnisse in Mobiltelefon-Apps einbetten, offene Relay-Endpunkte bereitstellen oder Entriegelungs-URLs protokollieren. Auch physische Schutzmaßnahmen sind wichtig: Fernbefehle erreichen ausschließlich vernetzte Schlösser, und bei Türen mit hohem Sicherheitsniveau ist die Fernentriegelung oft vollständig deaktiviert oder erfordert eine doppelte Genehmigung. Fordern Sie im Rahmen der Due Diligence das Sicherheits-Whitepaper, das Verfahren zur Token-Rotation und das Signaturverfahren für Webhooks an, statt lediglich die Angabe „REST-API verfügbar“ zu akzeptieren. Wir koordinieren diese Prüfungen mit dem Plattformteam und können Architekturen vorschlagen, bei denen die Fernentriegelung auf Empfangsrollen beschränkt ist.
Webhooks sind der Standard-Ereigniskanal – Entriegelungsprotokolle, Codeeingaben, niedrige Batteriestände, Manipulationswarnungen und Änderungen an Türsensoren –, die Zustellungssemantik variiert jedoch je nach Plattform. Professionelle Plattformen signieren Payloads, wiederholen fehlgeschlagene Zustellungen mit Backoff und bieten eine API zum Abgleichen oder Abrufen verpasster Ereignisse. Dies ist wichtig, weil Netzwerke kurzzeitig ausfallen und doppelte Zustellungen normal sind; Verbraucher müssen Ereignis-IDs daher idempotent behandeln. Garantien zur Reihenfolge sind schwächer: Zwei nur Sekunden auseinanderliegende Ereignisse können gelegentlich in umgekehrter Reihenfolge eintreffen. Die Audit-Logik sollte daher einen Zeitstempel aus der Zeit des Schlossereignisses verwenden, nicht aus der Ankunftszeit. Simulieren Sie während des Pilotprojekts einen Offline-Empfänger und überprüfen Sie das Wiedergabeverhalten. Ereigniskatalog, Wiederholungsrichtlinie und Abgleich-Endpunkte der bestellten Plattform werden vor Entwicklungsbeginn schriftlich dokumentiert.
Der API-Zugang wird von der Schlossplattform unter deren eigenen Entwickler- und Nutzungsbedingungen gewährt, in der Regel dem Kontoinhaber: der Marke oder dem Betreiber, der das Cloud-Projekt besitzt, und nicht automatisch jedem Käufer eines Schlosses. Das Werk kann dabei helfen, den Dienst zu aktivieren, Dokumentation bereitzustellen und das technische Onboarding zu koordinieren, kann jedoch keine Rechte über die Plattformvereinbarung hinaus zuweisen. Einige Plattformen unterscheiden nur App-Nutzer, Unternehmenskonten mit Dashboards und zertifizierte Entwicklerpartner mit vollständigem API-Zugang; fortgeschrittene Endpunkte erfordern in einigen Fällen eine genehmigte Integrationsprüfung. Käufer, die tiefgreifende Integrationen planen, sollten daher vor der Auswahl der Hardware die Entwicklerberechtigung, Gebühren, Datenverarbeitungsbedingungen und unterstützten Regionen bestätigen, denn ein ausgezeichnetes Schloss ohne API-Berechtigung kann das geplante Produkt nicht betreiben. Aktuelle Entwicklerprogramme und die Lizenzierung je Plattform werden in jeder RFQ bestätigt.
Teilen Sie uns Ihre Integrationsanwendungsfälle, Ihren Technologie-Stack und Ihren Startzeitplan in Ihrer RFQ mit. Wir koordinieren API-Dokumentation, SDK-Pakete, Testgeräte und Plattformvereinbarungen und unterstützen ein gemeinsames Pilotprojekt, das Offline-Betrieb, Wiederholungen und Ereignisse im großen Bestand abdeckt.
Datenblatt und Angebot anfordernTechnologieübersichtZuletzt aktualisiert: 31. Oktober 2026 · Geprüft vom Redaktionsteam des Smart Lock Factory