Online Booking API
Verbindet die Buchungsmaschine auf der Website des Hotels mit HMS: Zimmer- und Preisliste, Verfügbarkeitskalender, Gutscheine, Zahlung und Buchungsübermittlung.
- Basis-URL
https://test.hms.gen.tr- Authentifizierung
- apiKey / apiSecret → Bearer-Token
- Format
- JSON-Antworten · Request-Body als Formular oder JSON
- Umfang
- 8 Ressourcen · 16 Endpunkte
Ressourcen#
Authentifizierung
1 EndpunktDer Zugriff auf die Online Booking API erfolgt mit Partner-Zugangsdaten, die HMS vergibt. Der Anmelde-Endpunkt tauscht apiKey und apiSecret gegen ein …
- POST
/external/public/login
Zimmer und Preise
2 EndpunkteZwei Endpunkte liefern die Suchergebnisse der Buchungsmaschine: die Zimmerliste, die verkaufbare Zimmertypen, Verpflegungsarten und Preise für den ang…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Buchung
1 EndpunktDas vom Gast gewählte Zimmer, die Verpflegungsart und der Preis werden als BookingPushRQ-Struktur an HMS übermittelt. Derselbe Endpunkt verarbeitet au…
- POST
/external/online/channel/booking
Zahlung
3 EndpunkteListet die Zahlungsarten auf, die das Hotel für Online-Buchungen akzeptiert, und startet den Zahlungsschritt für die gewählte Art. Was bei welcher Zah…
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Gutschein
1 EndpunktPrüft die Online-Rabattgutscheine, die das Hotel im Panel angelegt hat. Wenden Sie den Rabatt auf Ihrer Seite an und senden Sie bei der Buchungsübermi…
- POST
/external/online/coupon/search
Pakete und Extras
1 EndpunktExtras, die zusammen mit einer Buchung verkauft werden können: Zimmerpakete (an einen Zimmertyp gebunden) und allgemeine Pakete (Transfer, Abendessen,…
- GET
/external/stock/packages
Hotelinformationen
4 EndpunkteDaten für den Seitenrahmen der Buchungsmaschine: Kontaktdaten und Lage, Social-Media-Links, Fußzeilentexte (Rechtliches, Über das Hotel, Analytics- un…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 weitere
Stammdaten
3 EndpunkteStatische Listen für Formularoptionen: Länder, Währungen und Sprachen. Sie ändern sich selten und können einen Tag lang zwischengespeichert werden.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Dokumentation#
Erste Schritte
- ÜberblickWas die Online Booking API leistet, Basis-URL, Ablauf im Überblick und allgemeine Regeln.
- SchnellstartHolen Sie mit Ihren Partner-Zugangsdaten ein Token und senden Sie Ihre erste Zimmer- und Preisabfrage.
- AuthentifizierungAnmeldung mit apiKey / apiSecret, Bearer-Token, Hotelkontext und Gültigkeitsdauer des Tokens.
- Anfragen und AntwortenFormular- und JSON-Bodys, der success-Envelope, Paginierung, Datums- und Betragsformate, HTTP-Statuscodes.
- Fehlercodesmessage- und errorCode-Werte, Authentifizierungsfehler und Hinweise zu Wiederholungsversuchen.