Ümumi baxış

Online Booking API otelin öz veb-saytındakı rezervasiya mühərrikini HMS Otel Proqramına qoşur. Otaq və qiymət siyahıları, təqvim üzrə mövcudluq, kuponun yoxlanılması, ödəniş addımı və rezervasiyanın HMS-ə ötürülməsi bu API vasitəsilə həyata keçirilir. API rezervasiya mühərriki hazırlayan agentliklər və HMS partnyorları üçün nəzərdə tutulub.

Əsas URL#

Bütün son nöqtələr aşağıdakı əsas URL altında, /external/… yolunda yerləşir. Yalnız HTTPS qəbul olunur.

API-nin əsas URL-i

https://test.hms.gen.tr

Axına qısa baxış#

1GirişPOST /external/public/login

2Otaqlar və qiymətlərPOST /external/online/roomType

3ÖdənişPOST …/payment/type/{type}

4RezervasiyaPOST …/channel/booking

Girişdə alınan token 7 gün etibarlıdır və bir otelə bağlıdır. Otaq siyahısı qonağın axtardığı tarixlər və qonaq sayı üçün satışa açıq otaqları və qiymətləri qaytarır; qonaq seçim etdikdən və ödəniş növü müəyyənləşdikdən sonra rezervasiya BookingPushRQ kimi HMS-ə yazılır. Rezervasiya axını bələdçisi bütün addımları ardıcıl izah edir.

Resurslar#

Resurs	Son nöqtələr
Autentifikasiya	POST `/external/public/login`
Otaqlar və qiymətlər	POST `/external/online/roomType` GET `/external/room/type/hotel/availability`
Rezervasiya	POST `/external/online/channel/booking`
Ödəniş	GET `/external/online/payment/type` GET `/external/payment/company` POST `/external/online/payment/type/{paymentType}`
Kupon	POST `/external/online/coupon/search`
Paketlər və əlavələr	GET `/external/stock/packages`
Otel məlumatları	GET `/external/hotel/{hotelID}/contact/info` GET `/external/online/social/media` GET `/external/online/footer` GET `/external/online/mail/host`
Soraq kitabçaları	POST `/external/counties` GET `/external/currencies` GET `/external/languages`

Ümumi qaydalar#

Girişdən başqa bütün sorğular Authorization: Bearer <token> başlığını daşıyır.
POST son nöqtələrinin çoxu forma sahələri qəbul edir (application/x-www-form-urlencoded və ya multipart/form-data). Rezervasiyanın ötürülməsi və ödənişin başladılması JSON gövdəsi gözləyir. Hansının tətbiq olunduğu hər son nöqtənin arayış səhifəsində göstərilib.
Cavablar success göstəricisi olan JSON-dur. Biznes qaydası xətaları da HTTP 200 ilə qayıdır; nəticəni status koduna görə deyil, success sahəsinə görə qiymətləndirin.
Tarixlər YYYY-MM-DD formatındadır, məbləğlər iki onluq rəqəmli sətirlərdir ("965.00"), valyuta isə otelin onlayn kanal ayarlarından götürülür.
hotelID parametri tokenin bağlı olduğu otellə üst-üstə düşməlidir.

Versiya#

Bu dokumentasiya HMS API V2 versiyasını əhatə edir. Yeni sahələr və son nöqtələr xəbərdarlıq edilmədən əlavə oluna bilər; klientinizi naməlum sahələrə məhəl qoymayacaq şəkildə yazın. Dəyişikliklər dəyişikliklər jurnalında göstərilir.

Növbəti addımlar#

Sürətli başlanğıcToken alın və ilk otaq sorğunuzu göndərin. AutentifikasiyaPartnyor açarları və tokenin etibarlılıq müddəti. Rezervasiya axınıAxtarışdan ötürməyədək, başdan-sona. API arayışıBütün son nöqtələr, parametrlər və nümunələr.

Son yenilənmə: 21 sentyabr 2026Səhv tapdınız? Bizə bildirin