Online Booking API
Otelin web sitesindeki rezervasyon motorunu HMS’e bağlar: oda ve fiyat listesi, takvim müsaitliği, kupon, ödeme ve rezervasyon aktarımı.
- API kökü
https://test.hms.gen.tr- Kimlik doğrulama
- apiKey / apiSecret → Bearer token
- Biçim
- JSON yanıt · form veya JSON istek gövdesi
- Kapsam
- 8 kaynak · 16 uç nokta
Kaynaklar#
Kimlik doğrulama
1 uç noktaOnline Booking API’ye erişim, HMS tarafından tanımlanan iş ortağı (partner) bilgileriyle yapılır. Giriş uç noktası apiKey ve apiSecret karşılığında bi…
- POST
/external/public/login
Oda ve fiyatlar
2 uç noktaRezervasyon motorunun arama sonucu ekranını besleyen iki uç nokta: verilen tarih ve kişi sayısı için satılabilir oda tiplerini, konaklama tiplerini ve…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Rezervasyon
1 uç noktaMisafirin seçtiği oda, konaklama tipi ve fiyat, BookingPushRQ yapısıyla HMS’e aktarılır. Aynı uç nokta, type alanı Cancel veya Modify gönderilerek ipt…
- POST
/external/online/channel/booking
Ödeme
3 uç noktaOtelin online rezervasyonda kabul ettiği ödeme tiplerini listeler ve seçilen tipe göre ödeme adımını başlatır. Hangi tipte ne yapılacağı Ödeme akışı r…
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Kupon
1 uç noktaOtelin panelde tanımladığı online indirim kuponlarını doğrular. İndirim, fiyat hesabına sizin tarafınızda uygulanır; rezervasyon aktarımında indirimli…
- POST
/external/online/coupon/search
Paketler ve ekstralar
1 uç noktaRezervasyon sırasında satılabilen ek hizmetler: oda paketleri (belirli oda tipine bağlı) ve genel paketler (transfer, akşam yemeği, spa gibi). Satılan…
- GET
/external/stock/packages
Otel bilgileri
4 uç noktaRezervasyon motorunun sayfa iskeletini besleyen bilgiler: iletişim ve konum, sosyal medya bağlantıları, alt bilgi metinleri (bilgiler, otel, analytics…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 daha
Tanımlar
3 uç noktaForm seçenekleri için sabit listeler: ülkeler, para birimleri ve diller. Nadiren değişir; bir gün önbelleklenebilir.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Dokümantasyon#
Başlangıç
- Genel bakışOnline Booking API ne yapar, temel adres, akış özeti ve genel kurallar.
- Hızlı başlangıçİş ortağı bilgileriyle token alıp ilk oda ve fiyat sorgusunu gönderin.
- Kimlik doğrulamaapiKey / apiSecret ile giriş, Bearer token, otel bağlamı ve token süresi.
- İstek ve yanıt biçimiForm ve JSON gövdeler, success zarfı, sayfalama, tarih ve tutar biçimleri, HTTP durum kodları.
- Hata kodlarımessage ve errorCode değerleri, kimlik doğrulama hataları ve yeniden deneme önerileri.