Online Booking API

Σε λειτουργίαHMS API V2API μηχανής κρατήσεων

Συνδέει τη μηχανή κρατήσεων του ιστότοπου του ξενοδοχείου με το HMS: λίστα δωματίων και τιμών, διαθεσιμότητα ημερολογίου, κουπόνια, πληρωμή και αποστολή κρατήσεων.

Βασικό URL
https://test.hms.gen.tr
Έλεγχος ταυτότητας
apiKey / apiSecret → Bearer token
Μορφή
Αποκρίσεις JSON · σώματα αιτημάτων form ή JSON
Εύρος
8 πόροι · 16 τελικά σημεία

Πόροι#

Έλεγχος ταυτότητας

1 τελικό σημείο

Η πρόσβαση στο Online Booking API γίνεται με διαπιστευτήρια συνεργάτη που εκδίδει το HMS. Το τελικό σημείο σύνδεσης ανταλλάσσει τα apiKey και apiSecre…

  • POST/external/public/login

Δωμάτια και τιμές

2 τελικά σημεία

Δύο τελικά σημεία που τροφοδοτούν τα αποτελέσματα αναζήτησης της μηχανής κρατήσεων: η λίστα δωματίων, που επιστρέφει τους τύπους δωματίων που μπορούν …

  • POST/external/online/roomType
  • GET/external/room/type/hotel/availability

Κράτηση

1 τελικό σημείο

Το δωμάτιο, ο τύπος διατροφής και η τιμή που επέλεξε ο επισκέπτης αποστέλλονται στο HMS σε δομή BookingPushRQ. Το ίδιο τελικό σημείο χειρίζεται ακυρώσ…

  • POST/external/online/channel/booking

Πληρωμή

3 τελικά σημεία

Επιστρέφει τους τύπους πληρωμής που δέχεται το ξενοδοχείο για online κρατήσεις και ξεκινά το βήμα πληρωμής για τον επιλεγμένο τύπο. Τι κάνετε για κάθε…

  • GET/external/online/payment/type
  • GET/external/payment/company
  • POST/external/online/payment/type/{paymentType}

Κουπόνι

1 τελικό σημείο

Επικυρώνει τα online εκπτωτικά κουπόνια που έχει ορίσει το ξενοδοχείο στον πίνακα διαχείρισης. Εφαρμόστε την έκπτωση από τη δική σας πλευρά και στείλτ…

  • POST/external/online/coupon/search

Πακέτα και επιπλέον υπηρεσίες

1 τελικό σημείο

Επιπλέον υπηρεσίες που μπορούν να πωληθούν μαζί με μια κράτηση: πακέτα δωματίου (συνδεδεμένα με έναν τύπο δωματίου) και γενικά πακέτα (μεταφορά, δείπν…

  • GET/external/stock/packages

Στοιχεία ξενοδοχείου

4 τελικά σημεία

Δεδομένα για το πλαίσιο των σελίδων της μηχανής κρατήσεων: στοιχεία επικοινωνίας και τοποθεσία, σύνδεσμοι κοινωνικών δικτύων, κείμενα υποσέλιδου (νομι…

  • GET/external/hotel/{hotelID}/contact/info
  • GET/external/online/social/media
  • GET/external/online/footer
  • +1 ακόμη

Λίστες αναφοράς

3 τελικά σημεία

Στατικές λίστες για τις επιλογές των φορμών: χώρες, νομίσματα και γλώσσες. Αλλάζουν σπάνια και μπορούν να διατηρούνται στην cache για μία ημέρα.

  • POST/external/counties
  • GET/external/currencies
  • GET/external/languages

Τεκμηρίωση#

Πρώτα βήματα

Οδηγοί

Τελευταία ενημέρωση: 21 Σεπτεμβρίου 2026Βρήκατε κάποιο λάθος; Ενημερώστε μας