API-Zugang

Premium-Konten können ihre eigenen Flug-, Display- und Analysedaten

programmatisch lesen — für eine Hotel-App, eine eigene Lobby-Installation

oder einen Bericht, der woanders lebt.

Einen Schlüssel bekommen

Benutzermenü → API-Zugang → Schlüssel erstellen. Der Schlüssel wird

genau einmal gezeigt, beim Anlegen. Wir speichern nur seinen Hash — ein

nicht kopierter Schlüssel lässt sich nicht wiederherstellen. Dann legt

einen neuen an und löscht den alten.

Schlüssel beginnen mit lf_live_. Schickt ihn als Bearer-Token:

curl -H "Authorization: Bearer lf_live_..." \
  https://lobbyflight.com/api/v1/displays

Ein Schlüssel kann ein Ablaufdatum bekommen. Macht das bei allem, was ihr

einer Agentur oder einem Dienstleister gebt.

GET	`/api/v1/displays`	Alle Displays eures Hotels
Methode	Endpunkt	Was zurückkommt
---	---	---
GET	`/api/v1/displays/{id}`	Die Konfiguration eines Displays
GET	`/api/v1/displays/{id}/flights`	Die Flüge, die es gerade zeigt
GET	`/api/v1/displays/{id}/analytics`	Aufrufe und Interaktionen dazu
GET	`/api/v1/flights/{airport}`	Abflüge und Ankünfte eines Flughafens
GET	`/api/v1/weather/{airport}`	Aktuelles Wetter und Vorhersage
GET	`/api/v1/analytics`	Analysen über das ganze Hotel

Alles ist nur lesend und auf das Hotel des Schlüssels begrenzt. Es gibt

keinen Endpunkt, der ein Display ändert; geschrieben wird nur im Portal.

60 Anfragen pro Minute, je Schlüssel gezählt. Darüber kommt ein 429

mit einem Retry-After-Header, der die Wartezeit in Sekunden nennt.

Wer Flüge für einen eigenen Bildschirm abfragt, kommt mit einmal pro

Minute reichlich aus — die Daten darunter bewegen sich ohnehin nicht

schneller als das Aktualisierungsintervall eures Tarifs.

401 — Schlüssel falsch, gelöscht oder abgelaufen. Prüft die ganze

Zeichenkette; ein abgeschnittener Schlüssel sieht gültig aus und ist es

nicht.

403 — gültiger Schlüssel, der etwas von einem anderen Hotel will.

429 — das Rate-Limit. Wartet die Zeit aus Retry-After ab.