Общ преглед
Online Booking API свързва резервационната система на собствения уебсайт на хотела с Хотелски софтуер HMS. Списъците със стаи и цени, наличността в календара, проверката на купони, стъпката на плащане и изпращането на резервацията към HMS минават през този API. Той е предназначен за агенции, които разработват резервационни системи, и за партньорите на HMS.
Базов URL#
Всички крайни точки се намират под базовия URL по-долу, в пътя /external/…. Приема се само HTTPS.
https://test.hms.gen.trПроцесът накратко#
POST /external/public/loginPOST /external/online/roomTypePOST …/payment/type/{type}POST …/channel/bookingТокенът от входа е валиден 7 дни и е обвързан с един хотел. Списъкът със стаи връща наличните за продажба стаи и цени за датите и броя гости, които гостът е търсил; след като гостът направи избор и типът плащане е уточнен, резервацията се записва в HMS като BookingPushRQ. Ръководството Процес на резервация разглежда всяка стъпка.
Ресурси#
| Ресурс | Крайни точки |
|---|---|
| Удостоверяване | POST /external/public/login |
| Стаи и цени | POST /external/online/roomTypeGET /external/room/type/hotel/availability |
| Резервация | POST /external/online/channel/booking |
| Плащане | GET /external/online/payment/typeGET /external/payment/companyPOST /external/online/payment/type/{paymentType} |
| Купон | POST /external/online/coupon/search |
| Пакети и допълнителни услуги | GET /external/stock/packages |
| Информация за хотела | GET /external/hotel/{hotelID}/contact/infoGET /external/online/social/mediaGET /external/online/footerGET /external/online/mail/host |
| Номенклатури | POST /external/countiesGET /external/currenciesGET /external/languages |
Общи правила#
- Всяка заявка освен входа съдържа заглавка
Authorization: Bearer <token>. - Повечето крайни точки с
POSTприемат полета на форма (application/x-www-form-urlencodedилиmultipart/form-data). Изпращането на резервация и стартирането на плащане очакват JSON тяло. Справочната страница на всяка крайна точка посочва кой формат се използва. - Отговорите са в JSON с флаг
success. Грешките от бизнес правилата също се връщат с HTTP200; преценявайте резултата поsuccess, а не по кода за състояние. - Датите са във формат
YYYY-MM-DD, сумите са низове с два знака след десетичната точка ("965.00"), а валутата идва от настройките на онлайн канала на хотела. - Параметърът
hotelIDтрябва да съвпада с хотела, с който е обвързан токенът.
Версия#
Тази документация обхваща HMS API V2. Нови полета и крайни точки могат да се добавят без предупреждение; пишете клиента си така, че да пренебрегва непознати полета. Промените са описани в дневника на промените.