სწრაფი დაწყება

ამ გვერდზე პარტნიორის მონაცემებით მიიღებთ ტოკენს და გაგზავნით ოთახებისა და ტარიფების მოთხოვნას. დაგჭირდებათ apiKey, apiSecret და სასტუმროს HMS ID (hotelID); თუ ისინი ჯერ არ გაქვთ, მიმართეთ მხარდაჭერას.

1. ტოკენის მიღება#

შესვლის ენდპოინტი ფორმის ველებს იღებს და ავთენტიფიკაციის სათაურს არ საჭიროებს:

ტერმინალი
curl "https://test.hms.gen.tr/external/public/login" \
  -d "apiKey=$HMS_API_KEY" \
  -d "apiSecret=$HMS_API_SECRET" \
  -d "hotelCode=1000"
პასუხი · 200
{
    "success": true,
    "hotelCode": "1000",
    "token": "eyJlbmREYXRlIjp7ImRhdGUiOiIyMDI2LTA5LTE1IDEwOjI0OjMxLjAwMDAwMCIs…",
    "hotelSeoUrl": "demo-otel"
}

შეინახეთ token; იგი 7 დღის განმავლობაში ამ სასტუმროს ყველა მოთხოვნაში გამოიყენება.

ტერმინალი
export HMS_TOKEN="eyJlbmREYXRlIjp7ImRhdGUiOiIyMDI2LTA5LTE1IDEwOjI0OjMxLjAwMDAwMCIs…"

2. ოთახებისა და ტარიფების მოთხოვნა#

ორი ღამის ძიება ორი ზრდასრულისთვის:

მოთხოვნა
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" \
  -d "language=en"

3. პასუხის წაკითხვა#

თითოეული ოთახის ტიპი შეიცავს თავის კვების ტიპებს (accommodationTypes), ხოლო თითოეული კვების ტიპი — ფასის ვარიანტებს (prices). შემოკლებული მაგალითი:

პასუხი · 200 (შემოკლებული)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Standard Room",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Bed & Breakfast",
                    "priceType": 0,
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "currency": "TRY",
                            "nonRefundable": "",
                            "id": "2/2"
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "currency": "TRY",
                            "nonRefundable": "[NR]",
                            "id": "2-0/2"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}
  • 2-1: 2 ადამიანი, სტანდარტული (დაბრუნებადი) ტარიფი. 2-0: 2 ადამიანი, დაუბრუნებადი ტარიფი (nonRefundable: "[NR]").
  • price მთელი ყოფნის ჯამური თანხაა; total — ღამეების რაოდენობა. ღამის ტარიფები სრული პასუხის prices[] მასივშია.
  • ჯავშანში ოთახის ტიპის id იგზავნება როგორც roomTypeID, ხოლო კვების ტიპის id — როგორც ratePlanID.

სად გავაგრძელოთ#

ბოლო განახლება: 21 სექტემბერი, 2026იპოვეთ შეცდომა? შეგვატყობინეთ