Genel bakış
Online Booking API, otelin kendi web sitesindeki rezervasyon motorunu HMS Otel Programı’na bağlar. Oda ve fiyat listesi, takvim müsaitliği, kupon doğrulama, ödeme adımı ve rezervasyonun HMS’e aktarımı bu API üzerinden yapılır. Rezervasyon motoru geliştiren ajanslar ve HMS iş ortakları için tasarlanmıştır.
Temel adres#
Tüm uç noktalar aşağıdaki kök adresin altında, /external/… yolunda yer alır. Yalnızca HTTPS kabul edilir.
https://test.hms.gen.trAkış özeti#
POST /external/public/loginPOST /external/online/roomTypePOST …/payment/type/{tip}POST …/channel/bookingGiriş ile alınan token 7 gün geçerlidir ve otele bağlıdır. Oda listesi misafirin aradığı tarih ve kişi sayısı için satılabilir odaları fiyatlarıyla döner; misafir seçimini yapıp ödeme tipini belirledikten sonra rezervasyon BookingPushRQ yapısıyla HMS’e yazılır. Ayrıntılı anlatım Rezervasyon akışı rehberindedir.
Kaynaklar#
| Kaynak | Uç noktalar |
|---|---|
| Kimlik doğrulama | POST /external/public/login |
| Oda ve fiyatlar | POST /external/online/roomTypeGET /external/room/type/hotel/availability |
| Rezervasyon | POST /external/online/channel/booking |
| Ödeme | GET /external/online/payment/typeGET /external/payment/companyPOST /external/online/payment/type/{paymentType} |
| Kupon | POST /external/online/coupon/search |
| Paketler ve ekstralar | GET /external/stock/packages |
| Otel bilgileri | GET /external/hotel/{hotelID}/contact/infoGET /external/online/social/mediaGET /external/online/footerGET /external/online/mail/host |
| Tanımlar | POST /external/countiesGET /external/currenciesGET /external/languages |
Genel kurallar#
- Giriş dışındaki her istek
Authorization: Bearer <token>başlığı taşır. - Çoğu
POSTuç noktası form alanları alır (application/x-www-form-urlencodedveyamultipart/form-data). Rezervasyon aktarımı ve ödeme başlatma JSON gövde bekler. Her uç noktanın referans sayfasında hangisi olduğu yazar. - Yanıtlar JSON’dur ve
successalanı taşır. İş kuralı hataları da HTTP200ile döner; sonucu HTTP koduna değilsuccessalanına göre değerlendirin. - Tarihler
YYYY-MM-DD, tutarlar iki ondalıklı string ("965.00"), para birimi otelin online kanal ayarından gelir. hotelIDparametresi token’ın bağlı olduğu otelle aynı olmalıdır.
Sürüm#
Bu dokümantasyon HMS API V2 içindir. Yeni alan ve uç nokta eklemeleri duyurusuz yapılabilir; istemcinizi tanımadığı alanları yok sayacak şekilde yazın. Değişiklikler sürüm notlarında listelenir.