Tərtibatçı portalıHMS Otel Proqramı

Proqram təminatınızı HMS modullarına qoşun

Otel proqramının hər modulu üçün ayrıca API dokumentasiyası: rezervasiya mühərriki, qonaqlar üçün Wi-Fi, restoran POS, spa, TV, ATS və süni intellekt xidmətləri. Online Booking və Hotspot API-ləri artıq aktivdir; digərləri ardınca gələcək.

Autentifikasiya
Bearer token və ya ApiKey başlığı
Format
JSON cavablar, success zərfi
Aktiv
2 məhsul · 17 son nöqtə
Hazırlanır
5 məhsul
Sorğu
# Otaq və qiymət sorğusu
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
Cavab · 200 (qısaldılıb)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Standart otaq",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Səhər yeməyi daxil",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Məhsullar

Hər məhsulun öz dokumentasiyası, API arayışı və kod nümunələri var. Hazırlananlar istifadəyə veriləndə dəyişikliklər jurnalında elan olunur.

Aktiv

Online Booking

Rezervasiya mühərriki API-si

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.

8 resurs · 16 son nöqtəDokumentasiya
Aktiv

Hotspot

Qonaqlar üçün Wi-Fi və 5651 qeydləri

Oteldə qalan qonaqların siyahısını hotspot sisteminə ötürür: otaq, şəxsiyyət məlumatları, check-in və check-out vaxtları. Qonaqların Wi-Fi girişini otaq nömrəsi ilə yoxlamaq və Türkiyənin 5651 saylı qanununa uyğun giriş jurnallarını aparmaq üçün.

1 resurs · 1 son nöqtəDokumentasiya
Hazırlanır

Restoran POS

Çeklər və otaq hesabına yazma

Restoran, bar və kafe çeklərinin otaq foliosuna yazılması, menyu və stok sinxronizasiyası.

Dokumentasiya hazırlanır
Hazırlanır

Spa

Seanslar və xidmətlər

Spa və wellness seanslarına yazılış, xidmət kataloqu və otaq hesabına yazma inteqrasiyası.

Dokumentasiya hazırlanır
Hazırlanır

Süni intellekt

Assistent və tövsiyə xidmətləri

Qonaq assistenti, qiymət tövsiyələri və hesabatlar üçün süni intellekt xidmətlərinə çıxış.

Dokumentasiya hazırlanır
Hazırlanır

TV

Otaqdaxili TV sistemləri

Otaqdakı TV interfeysi üçün qonaq məlumatları, folio, mesajlar və xidmət müraciətləri.

Dokumentasiya hazırlanır
Hazırlanır

ATS

ATS və zəng qeydləri

ATS inteqrasiyası: check-in/out zamanı xətlərin açılıb-bağlanması, zəng haqlarının folioya yazılması.

Dokumentasiya hazırlanır

Bütün məhsullar üçün ortaq prinsiplər

Bir modulu inteqrasiya etmisinizsə, digərləri sizə tanış gələcək.

Otelə bağlı açar

Online Booking-də HMS-in verdiyi apiKey/apiSecret 7 gün etibarlı, otelə bağlı Bearer token ilə dəyişdirilir. Hotspot kimi otel daxilində quraşdırılan inteqrasiyalar otelin öz panelində yaradılan açardan istifadə edir; bu açar hər sorğuda ApiKey başlığında göndərilir.

Autentifikasiya

success zərfi

Cavablar JSON formatındadır və success göstəricisi daşıyır. Biznes qaydası xətaları HTTP 200 ilə, message və ya errorCode sahəsində qayıdır; autentifikasiya xətaları 401-dir.

Sorğular və cavablar

İşlək nümunələr

Hər son nöqtə üçün cURL, Node.js və PHP nümunələri yaradılır; kopyalayın, açarınızı əlavə edin və işə salın.

API arayışı

Son dəyişikliklər

Tam dəyişikliklər jurnalı

  • Sayt
    22 dil dəstəyi
    YeniYeni
  • Hotspot
    Hotspot API dokumentasiyası dərc edildi
    YeniYeni
  • Online Booking
    Online Booking API dokumentasiyası dərc edildi
    YeniYeniYeni

Çətinlik çəkirsiniz?

Tərtibatçı komandamız bir iş günü ərzində cavab verir.

Sorğunun gövdəsini (gizli açarlar və kart məlumatları maskalanmış halda), cavabı və vaxtı əlavə edin. Partnyor açarları, test otelləri və erkən çıxış üçün də eyni ünvana yazın.