მიმოხილვა

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

საბაზო URL#

ყველა ენდპოინტი ქვემოთ მოცემულ საბაზო URL-ზე, /external/… ბილიკზეა განთავსებული. მიიღება მხოლოდ HTTPS.

API-ის საბაზო URL

https://test.hms.gen.tr

პროცესი მოკლედ#

1შესვლაPOST /external/public/login

2ოთახები და ტარიფებიPOST /external/online/roomType

3გადახდაPOST …/payment/type/{type}

4ჯავშანიPOST …/channel/booking

შესვლისას მიღებული ტოკენი 7 დღე მოქმედებს და ერთ სასტუმროზეა მიბმული. ოთახების სია აბრუნებს გასაყიდად ხელმისაწვდომ ოთახებსა და ფასებს იმ თარიღებისა და სტუმრების რაოდენობისთვის, რომლითაც სტუმარმა მოძებნა; როცა სტუმარი არჩევანს გააკეთებს და გადახდის ტიპი განისაზღვრება, ჯავშანი HMS-ში BookingPushRQ სტრუქტურით ჩაიწერება. ყველა ნაბიჯი დეტალურად აღწერილია სახელმძღვანელოში დაჯავშნის პროცესი.

რესურსები#

რესურსი	ენდპოინტები
ავთენტიფიკაცია	POST `/external/public/login`
ოთახები და ტარიფები	POST `/external/online/roomType` GET `/external/room/type/hotel/availability`
ჯავშანი	POST `/external/online/channel/booking`
გადახდა	GET `/external/online/payment/type` GET `/external/payment/company` POST `/external/online/payment/type/{paymentType}`
კუპონი	POST `/external/online/coupon/search`
პაკეტები და დამატებითი სერვისები	GET `/external/stock/packages`
სასტუმროს ინფორმაცია	GET `/external/hotel/{hotelID}/contact/info` GET `/external/online/social/media` GET `/external/online/footer` GET `/external/online/mail/host`
საცნობარო სიები	POST `/external/counties` GET `/external/currencies` GET `/external/languages`

ზოგადი წესები#

შესვლის გარდა ყველა მოთხოვნა შეიცავს Authorization: Bearer <token> სათაურს.
POST ენდპოინტების უმეტესობა იღებს ფორმის ველებს (application/x-www-form-urlencoded ან multipart/form-data). ჯავშნის გადაცემა და გადახდის დაწყება JSON ტანს ელოდება. რომელი ფორმატი გამოიყენება, მითითებულია თითოეული ენდპოინტის ცნობარის გვერდზე.
პასუხები JSON ფორმატშია და შეიცავს success ველს. ბიზნეს-წესების შეცდომებიც HTTP 200-ით ბრუნდება; შედეგი success ველით შეაფასეთ და არა სტატუსის კოდით.
თარიღები YYYY-MM-DD ფორმატშია, თანხები — სტრიქონები ორი ათწილადი ნიშნით ("965.00"), ხოლო ვალუტა სასტუმროს ონლაინ არხის პარამეტრებიდან მოდის.
hotelID პარამეტრი უნდა ემთხვეოდეს სასტუმროს, რომელზეც ტოკენია მიბმული.

ვერსია#

ეს დოკუმენტაცია HMS API-ის V2 ვერსიას ეხება. ახალი ველები და ენდპოინტები შეიძლება გაფრთხილების გარეშე დაემატოს; კლიენტი ისე დაწერეთ, რომ უცნობ ველებს უგულებელყოფდეს. ცვლილებები აღრიცხულია ცვლილებების ჟურნალში.

შემდეგი ნაბიჯები#

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

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