დეველოპერების პორტალიHMS სასტუმროს პროგრამა

დააკავშირეთ თქვენი პროგრამა 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"
პასუხი · 200 (შემოკლებული)
{
    "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
}

პროდუქტები

თითოეულ პროდუქტს აქვს საკუთარი დოკუმენტაცია, API ცნობარი და კოდის მაგალითები. მომზადების პროცესში მყოფ პროდუქტებს გამოქვეყნებისას ცვლილებების ჟურნალში გამოვაცხადებთ.

აქტიური

Online Booking

დაჯავშნის სისტემის API

აკავშირებს სასტუმროს ვებსაიტის დაჯავშნის სისტემას HMS-თან: ოთახებისა და ტარიფების სია, კალენდრის ხელმისაწვდომობა, კუპონები, გადახდა და ჯავშნის გადაცემა.

8 რესურსი · 16 ენდპოინტიდოკუმენტაცია
აქტიური

Hotspot

სტუმრების Wi-Fi და №5651 კანონის ჟურნალი

სასტუმროში მყოფი სტუმრების სიას აწვდის hotspot სისტემას: ოთახი, პირადობის მონაცემები, ჩასახლებისა და გაწერის დრო. Wi-Fi-ში სტუმრის შესვლის ოთახის ნომრით დასადასტურებლად და თურქეთის №5651 კანონით მოთხოვნილი წვდომის ჟურნალის საწარმოებლად.

1 რესურსი · 1 ენდპოინტიდოკუმენტაცია
მზადდება

რესტორნის 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
    გამოქვეყნდა Hotspot API-ის დოკუმენტაცია
    ახალიახალი
  • Online Booking
    გამოქვეყნდა Online Booking API-ის დოკუმენტაცია
    ახალიახალიახალი

გაგიჭირდათ?

ჩვენი დეველოპერების გუნდი ერთი სამუშაო დღის განმავლობაში გიპასუხებთ.

მიუთითეთ მოთხოვნის ტანი (საიდუმლო გასაღებები და ბარათის მონაცემები დაფარული), პასუხი და დრო. იგივე მისამართი გამოიყენეთ პარტნიორის გასაღების, სატესტო სასტუმროსა და ადრეული წვდომის მოთხოვნებისთვის.