Für technische Teams: Übersicht der von unseren Modulen verwendeten Rezlynx-API-Endpunkte, Authentifizierung per JWT, Rate-Limiting, Fehlerbehandlung.
Die Rezlynx-API verwendet JWT-Token zur Authentifizierung. Sie erzeugen einen Token im Guestline Kundenbereich unter Mein Konto → Integrationen → Neuer API-Token. Der Token hat eine Standardgültigkeit von 12 Monaten und muss anschließend rotiert werden. Der Token wird als Authorization: Bearer <token>-Header in jeder API-Anfrage mitgesendet.
| Endpunkt | Methode | Zweck |
|---|---|---|
| /availability | GET | Verfügbarkeit pro Zimmertyp und Datum |
| /rates | GET, PUT | Ratenpflege pro Ratenplan |
| /restrictions | GET, PUT | MinLOS, MaxLOS, CTA, CTD |
| /reservations | GET, POST | Reservierungen lesen und anlegen |
| /guests | GET, POST | Gastdaten |
| /payments | GET | Zahlungshistorie einer Reservierung |
| /reports | GET | Standardberichte (RevPAR, ADR) |
curl -H "Authorization: Bearer $TOKEN" \ "https://api.rezlynx.example/v3/availability?start=2026-09-01&end=2026-09-30"
Standardgrenze: 60 Anfragen pro Minute und Token. Bei Überschreitung antwortet die API mit HTTP 429 und dem Header Retry-After. GuestlineHub-Module implementieren ein exponentielles Backoff mit Jitter, wenn dieser Fall eintritt.
HTTP-Statuscodes: 200 (Erfolg), 400 (Fehlerhafte Anfrage), 401 (Ungültiger Token), 403 (Kein Zugriff auf diese Ressource), 404 (Nicht gefunden), 429 (Rate-Limit überschritten), 5xx (Server-Fehler). Antwort-Body im Format { "error": "beschreibung", "code": "REZ_..." }.