დააკავშირეთ თქვენი პროგრამა HMS-ის მოდულებთან
ცალკე API დოკუმენტაცია სასტუმროს პროგრამის ყოველი მოდულისთვის: დაჯავშნის სისტემა, სტუმრების Wi-Fi, რესტორნის POS, სპა, TV, სატელეფონო სადგური და ხელოვნური ინტელექტის სერვისები. Online Booking და Hotspot API უკვე ხელმისაწვდომია; დანარჩენები ეტაპობრივად დაემატება.
- ავთენტიფიკაცია
Bearerტოკენი ანApiKeyსათაური- ფორმატი
- JSON პასუხები,
successგარსი - აქტიური
- 2 პროდუქტი · 17 ენდპოინტი
- მზადდება
- 5 პროდუქტი
# ოთახებისა და ტარიფების მოთხოვნა
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"# სასტუმროში მყოფი სტუმრების სია
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": "სტანდარტული ოთახი",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "საუზმით",
"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
}
]
}პროდუქტები
თითოეულ პროდუქტს აქვს საკუთარი დოკუმენტაცია, API ცნობარი და კოდის მაგალითები. მომზადების პროცესში მყოფ პროდუქტებს გამოქვეყნებისას ცვლილებების ჟურნალში გამოვაცხადებთ.
Online Booking
დაჯავშნის სისტემის API
აკავშირებს სასტუმროს ვებსაიტის დაჯავშნის სისტემას HMS-თან: ოთახებისა და ტარიფების სია, კალენდრის ხელმისაწვდომობა, კუპონები, გადახდა და ჯავშნის გადაცემა.
Hotspot
სტუმრების Wi-Fi და №5651 კანონის ჟურნალი
სასტუმროში მყოფი სტუმრების სიას აწვდის hotspot სისტემას: ოთახი, პირადობის მონაცემები, ჩასახლებისა და გაწერის დრო. Wi-Fi-ში სტუმრის შესვლის ოთახის ნომრით დასადასტურებლად და თურქეთის №5651 კანონით მოთხოვნილი წვდომის ჟურნალის საწარმოებლად.
რესტორნის POS
ანგარიშები და ოთახზე დარიცხვა
რესტორნის, ბარისა და კაფის ანგარიშების ოთახის ფოლიოზე გადატანა, მენიუსა და მარაგების სინქრონიზაცია.
Spa
ვიზიტები და სერვისები
Spa და ველნეს ვიზიტები, სერვისების კატალოგი და ოთახზე დარიცხვის ინტეგრაცია.
ხელოვნური ინტელექტი
ასისტენტისა და რეკომენდაციების სერვისები
წვდომა ხელოვნური ინტელექტის სერვისებზე სტუმრის ასისტენტისთვის, ტარიფების რეკომენდაციებისა და ანგარიშგებისთვის.
TV
ოთახის TV სისტემები
სტუმრის მონაცემები, ფოლიო, შეტყობინებები და სერვისის მოთხოვნები ოთახის TV ინტერფეისისთვის.
სატელეფონო სადგური
PBX და ზარების ჩანაწერები
სატელეფონო სადგურის ინტეგრაცია: ხაზების ჩართვა და გამორთვა ჩასახლებისა და გაწერისას, ზარების ღირებულების ფოლიოზე დარიცხვა.
ყველა პროდუქტისთვის საერთო პრინციპები
თუ ერთი მოდული უკვე ინტეგრირებული გაქვთ, დანარჩენები ნაცნობი მოგეჩვენებათ.
სასტუმროზე მიბმული გასაღები
Online Booking-ში HMS-ის მიერ გაცემული apiKey/apiSecret იცვლება სასტუმროზე მიბმულ Bearer ტოკენზე, რომელიც 7 დღე მოქმედებს. სასტუმროს შიდა ინტეგრაციები, როგორიცაა Hotspot, იყენებს სასტუმროს საკუთარ პანელში გენერირებულ გასაღებს, რომელიც ყოველ მოთხოვნაში ApiKey სათაურით იგზავნება.
success გარსი
პასუხები JSON ფორმატშია და შეიცავს success ველს. ბიზნეს-წესების შეცდომები ბრუნდება HTTP 200-ით, message ან errorCode ველით; ავთენტიფიკაციის შეცდომები — 401-ით.
მუშა მაგალითები
ყოველი ენდპოინტისთვის გენერირდება cURL, Node.js და PHP მაგალითები; დააკოპირეთ, ჩასვით თქვენი გასაღები და გაუშვით.
API ცნობარიბოლო ცვლილებები
-
22 ენის მხარდაჭერაახალიახალი
-
გამოქვეყნდა Hotspot API-ის დოკუმენტაციაახალიახალი
-
გამოქვეყნდა Online Booking API-ის დოკუმენტაციაახალიახალიახალი
გაგიჭირდათ?
ჩვენი დეველოპერების გუნდი ერთი სამუშაო დღის განმავლობაში გიპასუხებთ.
მიუთითეთ მოთხოვნის ტანი (საიდუმლო გასაღებები და ბარათის მონაცემები დაფარული), პასუხი და დრო. იგივე მისამართი გამოიყენეთ პარტნიორის გასაღების, სატესტო სასტუმროსა და ადრეული წვდომის მოთხოვნებისთვის.