Online Booking API
Koppelt de boekingsmodule op de website van het hotel aan HMS: kamer- en tarievenlijst, beschikbaarheidskalender, kortingscodes, betaling en het doorsturen van boekingen.
- Basis-URL
https://test.hms.gen.tr- Authenticatie
- apiKey / apiSecret → Bearer-token
- Formaat
- JSON-antwoorden · formulier- of JSON-body
- Omvang
- 8 resources · 16 endpoints
Bronnen#
Authenticatie
1 endpointToegang tot de Online Booking API verloopt via partnergegevens die HMS verstrekt. Het login-endpoint wisselt apiKey en apiSecret in voor een token, da…
- POST
/external/public/login
Kamers en tarieven
2 endpointsTwee endpoints die de zoekresultaten van de boekingsmodule voeden: de kamerlijst, die verkoopbare kamertypen, verzorgingstypen en prijzen teruggeeft v…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Boeking
1 endpointDe kamer, het verzorgingstype en het tarief die de gast heeft gekozen, worden als BookingPushRQ-structuur naar HMS doorgestuurd. Hetzelfde endpoint ve…
- POST
/external/online/channel/booking
Betaling
3 endpointsToont de betaalmethoden die het hotel accepteert voor online boekingen en start de betaalstap voor de gekozen methode. Wat je per methode doet, staat …
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Kortingscode
1 endpointValideert de online kortingscodes die het hotel in het beheerpaneel heeft ingesteld. Pas de korting zelf toe en stuur bij het doorsturen van de boekin…
- POST
/external/online/coupon/search
Pakketten en extra’s
1 endpointExtra’s die bij een boeking kunnen worden verkocht: kamerpakketten (gekoppeld aan een kamertype) en algemene pakketten (transfer, diner, spa). Verkoch…
- GET
/external/stock/packages
Hotelinformatie
4 endpointsGegevens voor het paginaframe van de boekingsmodule: contactgegevens en locatie, links naar sociale media, footerteksten (juridische teksten, over het…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 meer
Keuzelijsten
3 endpointsStatische lijsten voor formulieropties: landen, valuta en talen. Ze veranderen zelden en kunnen een dag worden gecachet.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Documentatie#
Aan de slag
- OverzichtWat de Online Booking API doet, basis-URL, overzicht van de flow en algemene regels.
- SnelstartHaal met je partnergegevens een token op en vraag je eerste kamers en tarieven op.
- AuthenticatieInloggen met apiKey / apiSecret, Bearer-token, hotelcontext en geldigheidsduur van het token.
- Verzoeken en antwoordenFormulier- en JSON-body’s, de success-envelop, paginering, notatie van datums en bedragen, HTTP-statuscodes.
- FoutcodesWaarden van message en errorCode, authenticatiefouten en advies over opnieuw proberen.