Online Booking API
Otelin veb-saytındakı rezervasiya mühərrikini HMS-ə qoşur: otaq və qiymət siyahısı, təqvim üzrə mövcudluq, kuponlar, ödəniş və rezervasiyanın ötürülməsi.
- Əsas URL
https://test.hms.gen.tr- Autentifikasiya
- apiKey / apiSecret → Bearer token
- Format
- JSON cavablar · forma və ya JSON sorğu gövdələri
- Əhatə
- 8 resurs · 16 son nöqtə
Resurslar#
Autentifikasiya
1 son nöqtəOnline Booking API-yə çıxış HMS tərəfindən verilən partnyor giriş məlumatları ilə təmin olunur. Giriş son nöqtəsi apiKey və apiSecret müqabilində toke…
- POST
/external/public/login
Otaqlar və qiymətlər
2 son nöqtəRezervasiya mühərrikinin axtarış nəticələrini təmin edən iki son nöqtə: verilmiş tarixlər və qonaq sayı üçün satışa açıq otaq tiplərini, qidalanma tip…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Rezervasiya
1 son nöqtəQonağın seçdiyi otaq, qidalanma tipi və qiymət BookingPushRQ strukturu ilə HMS-ə ötürülür. Eyni son nöqtə type sahəsində Cancel və ya Modify göndərmək…
- POST
/external/online/channel/booking
Ödəniş
3 son nöqtəOtelin onlayn rezervasiyalar üçün qəbul etdiyi ödəniş növlərini siyahıya alır və seçilmiş növ üçün ödəniş addımını başladır. Hər növ üçün nə etmək laz…
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Kupon
1 son nöqtəOtelin paneldə təyin etdiyi onlayn endirim kuponlarını yoxlayır. Endirimi öz tərəfinizdə tətbiq edin və rezervasiya ötürülməsində endirimli məbləğləri…
- POST
/external/online/coupon/search
Paketlər və əlavələr
1 son nöqtəRezervasiya ilə birlikdə satıla bilən əlavələr: otaq paketləri (otaq tipinə bağlı) və ümumi paketlər (transfer, şam yeməyi, spa). Satılan paketlər rez…
- GET
/external/stock/packages
Otel məlumatları
4 son nöqtəRezervasiya mühərriki səhifəsinin ümumi hissələrini dolduran məlumatlar: əlaqə məlumatları və məkan, sosial media keçidləri, alt hissə mətnləri (hüquq…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 əlavə
Soraq kitabçaları
3 son nöqtəForma seçimləri üçün statik siyahılar: ölkələr, valyutalar və dillər. Nadir hallarda dəyişir, bir gün müddətinə keşlənə bilər.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Dokumentasiya#
Başlanğıc
- Ümumi baxışOnline Booking API nə edir: əsas URL, axının xülasəsi və ümumi qaydalar.
- Sürətli başlanğıcPartnyor giriş məlumatlarınızla token alın və ilk otaq-qiymət sorğunuzu göndərin.
- AutentifikasiyaapiKey / apiSecret ilə giriş, Bearer token, otel konteksti və tokenin etibarlılıq müddəti.
- Sorğular və cavablarForma və JSON gövdələri, success zərfi, səhifələmə, tarix və məbləğ formatları, HTTP status kodları.
- Xəta kodlarımessage və errorCode dəyərləri, autentifikasiya xətaları və təkrar cəhd tövsiyələri.