Häufigste Integrationen: So geht's

Die API-Schicht von LabKey ist stabil und wird seit Jahren produktiv eingesetzt, um die Zugangskontrolle mit Verwaltungssoftware, PMS, Buchungsplattformen und Zahlungssystemen zu verbinden. Dieser Leitfaden fasst die häufigsten Integrationsmuster zusammen — basierend auf realen, bereits produktiven Fällen, hier in allgemeiner Form beschrieben —, um sich vor der Planung der eigenen Integration schnell zu orientieren.

Wie Sie eine Integration starten

Je nach verfügbaren technischen Ressourcen gibt es drei mögliche Wege:

• Self-Service: Entwickeln Sie eigenständig ausgehend von der vollständigen API-Dokumentation, die auch in interaktiver Form auf Postman verfügbar ist.
• SDK und Startcode: Das LabKey-Team kann fertige SDKs und Code-Snippets für die häufigsten Muster bereitstellen, um die Entwicklung zu beschleunigen.
• Individuelle Integration: Das LabKey-Team kann die Integration im Auftrag des Kunden maßgeschneidert entwickeln.

Kontaktieren Sie uns, um gemeinsam den passendsten Weg für Ihr Projekt zu bewerten.

Häufigste Integrationsmuster

Im Folgenden die häufigsten Integrationsmuster, entnommen aus tatsächlich produktiven Integrationen (einige davon seit mehreren Jahren), in allgemeiner Form beschrieben.

Automatische Erstellung von Zugangsdaten aus einer Buchungssoftware

Die Buchungssoftware (Hotel-PMS, Software für Sportzentren oder Coworking-Spaces) meldet den Abschluss einer Buchung oder eines Check-ins; das System erstellt automatisch eine Zugangsberechtigung (Code, NFC-Schlüssel oder QR-Code), die nur für den Aufenthalts- oder Buchungszeitraum gültig ist, und sendet sie an den Benutzer.

Beteiligte Aufrufe: AddUser → GrantAccess → getqrcode oder UpdatePinpad → sendemail — siehe die Abschnitte Benutzer, Zugänge und Berechtigungen und Allgemein der API-Dokumentation.

Typisches Muster für die Integration mit Cloud-Verwaltungssoftware für Beherbergungsbetriebe wie Passepartout, Hotel in Cloud oder TeamSystem Hospitality (bereits LabKey-Partner).

Autorisierungsprüfung bei einem externen System vor der Öffnung

In manchen Kontexten (z. B. öffentliche Einrichtungen mit eigenem Autorisierungssystem) kommt die Öffnungsanfrage nicht direkt von LabKey: Ein externer Dienst prüft zunächst die Autorisierung bei der Drittsoftware und sendet erst je nach Ergebnis den Öffnungsbefehl. Nützlich, wenn die Autorisierungslogik zentral in einem bereits bestehenden System bleiben muss.

Verbrauchsbasierter Zugang mit aufladbarem Guthaben

Ein externer, geschützter Bereich ermöglicht dem Benutzer das Aufladen eines Guthabens (z. B. für Eintritte, Dienstleistungen oder Verbrauch); das verbleibende Guthaben wird bei jedem Zugang automatisch reduziert, mit automatischer Deaktivierung der Zugangsberechtigung bei aufgebrauchtem Guthaben.

Beteiligte Aufrufe: getcredits, recharge, getprices — siehe den Abschnitt Guthaben.

Öffentliche Selbstregistrierung mit Bestätigung durch einen Operator

Eine öffentliche Seite ermöglicht dem Benutzer die eigenständige Registrierung; das System erstellt einen provisorischen Code, der erst nach der manuellen Bestätigung durch einen Operator endgültig aktiviert wird.

Beteiligte Aufrufe: AddUser (deaktiviert erstellt) → Bestätigung durch Operator → GrantAccess.

Durch No-Code-Automatisierungen oder Online-Formulare ausgelöste Öffnung

Das Ausfüllen eines Online-Formulars (z. B. JotForm, bereits LabKey-Partner) oder eine Automatisierung auf No-Code-Plattformen (z. B. Zapier, Make) kann direkt die Öffnung eines Zugangspunkts auslösen, über die Aufrufe der API PRO.

Online-Zahlung, die den Zugang erzeugt

Eine Website oder ein Online-Shop mit integrierter Zahlung (z. B. Stripe) erstellt und sendet automatisch einen Zugangscode nach Abschluss einer Transaktion.

Öffnung aus der eigenen App über QR-Code

Soll die Öffnung aus der eigenen App statt über ein physisches Lesegerät erfolgen, lautet der typische Ablauf: AddUser → GrantAccess → getqrcode. Die App des Kunden zeigt den zurückgegebenen QR-Code an oder verarbeitet ihn, um den Zugang abzuschließen.

Bewusst zu prüfende Alternative: Wer es vorzieht, mit einem eigenen externen Gerät direkt auf das Relais der Steuereinheit zuzugreifen (der Kontakt ist potentialfrei, normalerweise offen — NO — und kann problemlos parallel angesteuert werden), umgeht damit vollständig die API-Schicht von LabKey: keine Authentifizierung, keine Protokollierung, keine der Panel-Funktionen. Das ist eine gültige Wahl, wenn die Autorisierungslogik bereits anderweitig verwaltet wird — man sollte sich aber bewusst sein, worauf man dabei verzichtet.

Coworking und gemeinsam genutzte Räume

Benutzergruppen mit anpassbaren Zeitfenstern, temporäre Zugänge über QR-Code, Eintrittszähler und Fernentzug von Zugangsberechtigungen sind allesamt native Funktionen des Systems, die auch über API verfügbar sind, um sie mit einer Website oder einer Raumbuchungssoftware zu integrieren.

Technische Voraussetzungen

Die Authentifizierung (Bearer-Token, an die autorisierte IP gebundener Secret Key) ist im Abschnitt Authentifizierung der API-Dokumentation beschrieben. Zwei Aspekte, die bei der Planung zu beachten sind:

• Die Aktivierung der API betrifft alle dem Panel zugeordneten Steuereinheiten: Eine Aktivierung nur für eine Auswahl ist nicht möglich.
• Es steht eine dedizierte Testumgebung zur Verfügung, die auf Anfrage aktiviert werden kann, um die Integration vor dem produktiven Einsatz zu validieren.

Service-Level: Standard und PRO

Der Standard-API-Dienst deckt den Großteil der oben beschriebenen Szenarien ab. Der Dienst API PRO ergänzt die Fernöffnung durch externe Software über dedizierte Aufrufe sowie das erweiterte Monitoring mit Protokollierung der API-Aufrufe.

Ihre Plattform ist nicht unter den aufgeführten Partnern?

Kein Problem: Die oben beschriebenen Muster gelten gleichermaßen auch für Plattformen, die noch nicht in der öffentlichen Liste der integrierten Partner erscheinen — zum Beispiel sind die wichtigsten Channel-Manager für Kurzzeitvermietungen wie Lodgify noch keine dokumentierte Integration, lassen sich aber mit demselben Standardmuster integrieren.

Kontaktieren Sie uns, um gemeinsam die Machbarkeit Ihrer Integration zu bewerten.