Online Booking API
Свързва резервационната система на уебсайта на хотела с HMS: списък със стаи и цени, наличност в календара, купони, плащане и изпращане на резервации.
- Базов URL
https://test.hms.gen.tr- Удостоверяване
- apiKey / apiSecret → Bearer токен
- Формат
- JSON отговори · тяло на заявката като форма или JSON
- Обхват
- 8 ресурса · 16 крайни точки
Ресурси#
Удостоверяване
1 крайна точкаДостъпът до Online Booking API става с партньорски идентификационни данни, издадени от HMS. Крайната точка за вход разменя apiKey и apiSecret срещу то…
- POST
/external/public/login
Стаи и цени
2 крайни точкиДве крайни точки, които захранват резултатите от търсенето в резервационната система: списъкът със стаи, който връща наличните за продажба типове стаи…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Резервация
1 крайна точкаИзбраните от госта стая, тип изхранване и цена се изпращат към HMS в структура BookingPushRQ. Същата крайна точка обработва анулации и промени, като в…
- POST
/external/online/channel/booking
Плащане
3 крайни точкиВръща типовете плащане, които хотелът приема за онлайн резервации, и стартира стъпката на плащане за избрания тип. Какво да направите при всеки тип е …
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Купон
1 крайна точкаПроверява онлайн купоните за отстъпка, които хотелът е създал в панела. Приложете отстъпката от ваша страна и изпратете намалените суми при изпращанет…
- POST
/external/online/coupon/search
Пакети и допълнителни услуги
1 крайна точкаДопълнителни услуги, които могат да се продават с резервацията: пакети за стаи (обвързани с тип стая) и общи пакети (трансфер, вечеря, спа). Продадени…
- GET
/external/stock/packages
Информация за хотела
4 крайни точкиДанни, които попълват рамката на страниците на резервационната система: данни за контакт и местоположение, връзки към социални мрежи, текстове във фут…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 още
Номенклатури
3 крайни точкиСтатични списъци за опциите във формите: държави, валути и езици. Променят се рядко и могат да се кешират за един ден.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Документация#
Първи стъпки
- Общ прегледКакво прави Online Booking API, базов URL, обобщение на процеса и общи правила.
- Бързо началоПолучете токен с партньорските си идентификационни данни и изпратете първата си заявка за стаи и цени.
- УдостоверяванеВход с apiKey / apiSecret, Bearer токен, контекст на хотела и валидност на токена.
- Заявки и отговориТела с полета на форма и JSON, обвивката success, странициране, формати на дати и суми, HTTP кодове за състояние.
- Кодове за грешкиСтойности на message и errorCode, грешки при удостоверяване и насоки за повторни опити.