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
Bearertoken və yaApiKeybaşlığı- Format
- JSON cavablar,
successzərfi - Aktiv
- 2 məhsul · 17 son nöqtə
- Hazırlanır
- 5 məhsul
# 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"# Oteldə qalan qonaqların siyahısı
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"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
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}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.
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.
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.
Restoran POS
Çeklər və otaq hesabına yazma
Restoran, bar və kafe çeklərinin otaq foliosuna yazılması, menyu və stok sinxronizasiyası.
Spa
Seanslar və xidmətlər
Spa və wellness seanslarına yazılış, xidmət kataloqu və otaq hesabına yazma inteqrasiyası.
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ış.
TV
Otaqdaxili TV sistemləri
Otaqdakı TV interfeysi üçün qonaq məlumatları, folio, mesajlar və xidmət müraciətləri.
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ı.
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.
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.
İş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
-
22 dil dəstəyiYeniYeni
-
Hotspot API dokumentasiyası dərc edildiYeniYeni
-
Online Booking API dokumentasiyası dərc edildiYeniYeniYeni
Çə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.