Fehlerantworten

Die Hotspot API kennt zwei Arten von Ergebnissen: eine fehlgeschlagene Authentifizierung (HTTP 401) und eine erfolgreiche Antwort (HTTP 200). Eine leere Gästeliste ist kein Fehler. Im Folgenden finden Sie die Situationen, auf die Sie stoßen können, und was jeweils zu tun ist.

HTTP-Statuscodes#

Code	Body	Bedeutung und Vorgehen
`200`	`{"success": 1, "otelde": [...]}`	Erfolg. Verarbeiten Sie die Liste.
`200`	`{"success": 1, "otelde": []}`	Erfolg; niemand ist im Haus. Beachten Sie den Hinweis zu leeren Listen unten.
`401`	`{"success": 0}`	`ApiKey`-Header fehlt oder Schlüssel nicht erkannt. Nicht wiederholen; prüfen Sie den Schlüssel und benachrichtigen Sie den Administrator.
`404`	Fehlerseite	Falscher Pfad. Prüfen Sie, ob der Pfad exakt `/public/json/customer/inhotel` lautet.
`405`	Fehlerseite	Es wurde eine andere Methode als `POST` verwendet (z. B. `GET` aus einem Browser).
`5xx` / Timeout	—	Vorübergehender Server- oder Netzwerkfehler. Wiederholen Sie mit zunehmenden Abständen (30 s, 1 min, 5 min) und verwenden Sie in der Zwischenzeit weiter die letzte erfolgreich abgerufene Liste.

Leere Liste#

otelde: [] bedeutet, dass keine eingecheckten Gäste im Haus sind – für kleine Hotels außerhalb der Saison normal. Eine Liste, die bei der vorherigen Abfrage gefüllt war und plötzlich leer ist, deutet jedoch meist auf einen Bedienfehler auf Hotelseite hin (ein fälschlicher Sammel-Check-out, eine Änderung des Reservierungsstatus). Bevor Sie alle WLAN-Konten schließen, vergewissern Sie sich, dass die Liste bei zwei aufeinanderfolgenden Abfragen leer war.

Wiederholungen und Timeouts#

Verwenden Sie für Anfragen einen Timeout von 10 Sekunden; selbst bei großen Hotels wird die Liste innerhalb dieser Zeit geliefert.
Wiederholen Sie bei 5xx und Netzwerkfehlern; wiederholen Sie 401, 404 und 405 nicht, da es sich um Konfigurationsfehler handelt.
Behalten Sie die letzte erfolgreiche Liste, solange eine Abfrage fehlschlägt. Schließen Sie Konten nur für Gäste, die in einer erfolgreichen Antwort nicht mehr in der Liste stehen.
Zählen Sie aufeinanderfolgende Fehlschläge und benachrichtigen Sie den Administrator ab einem Schwellenwert (z. B. 15 Minuten).

Häufige Situationen#

Situation	Wahrscheinliche Ursache	Vorgehen
Gast nicht in der Liste	Die Rezeption hat den Gast nicht eingecheckt, die Reservierung wurde storniert, der Gast ist nicht als „im Haus“ markiert oder hat bereits ausgecheckt.	Zeigen Sie im Portal „Zimmernummer und Nachname stimmen nicht überein“ an und verweisen Sie den Gast an die Rezeption. Ein erneuter Abruf ist nicht nötig; der Gast erscheint bei der nächsten Synchronisierung.
Mehrere Datensätze für dasselbe Zimmer	Im Zimmer wohnt mehr als ein Gast; jeder ist ein eigener Datensatz.	Normal. Eröffnen Sie Konten pro Gast (`unique`).
`identityNumber` leer	Der Gast wurde ohne Ausweisdaten erfasst.	Verwenden Sie für den Abgleich ersatzweise Nachname + Geburtsdatum; lassen Sie das Feld im Protokoll nach Gesetz Nr. 5651 leer und verknüpfen Sie es mit `unique`.
`roomName` stimmt nicht überein	Der Gast hat „0104“ oder „Zimmer 104“ statt „104“ eingegeben; der Wert ist ein String.	Normalisieren Sie beide Seiten vor dem Vergleich; nicht in eine Zahl umwandeln.
`checkout` liegt in der Vergangenheit, Gast aber noch gelistet	Der Gast hat verlängert oder reist später ab, und die Rezeption hat dies noch nicht erfasst.	Lassen Sie den Zugang offen, solange der Gast in der Liste steht; aktualisieren Sie das Sitzungsende, wenn sich `checkout` ändert.

Zuletzt aktualisiert: 21. September 2026Fehler gefunden? Schreiben Sie uns