Επισκόπηση

Το Online Booking API συνδέει τη μηχανή κρατήσεων στον ιστότοπο ενός ξενοδοχείου με το ξενοδοχειακό λογισμικό HMS. Οι λίστες δωματίων και τιμών, η διαθεσιμότητα ημερολογίου, η επικύρωση κουπονιών, το βήμα πληρωμής και η αποστολή της κράτησης στο HMS γίνονται όλα μέσω αυτού του API. Απευθύνεται σε εταιρείες που αναπτύσσουν μηχανές κρατήσεων και σε συνεργάτες του HMS.

Βασικό URL#

Όλα τα τελικά σημεία βρίσκονται κάτω από το παρακάτω βασικό URL, στη διαδρομή /external/…. Γίνεται δεκτό μόνο HTTPS.

https://test.hms.gen.tr

Η ροή με μια ματιά#

Το token της σύνδεσης ισχύει για 7 ημέρες και δεσμεύεται σε ένα ξενοδοχείο. Η λίστα δωματίων επιστρέφει τα δωμάτια που μπορούν να πωληθούν και τις τιμές τους για τις ημερομηνίες και τον αριθμό ατόμων που αναζήτησε ο επισκέπτης· όταν ο επισκέπτης κάνει την επιλογή του και οριστεί ο τύπος πληρωμής, η κράτηση καταχωρείται στο HMS ως BookingPushRQ. Ο οδηγός Ροή κράτησης περιγράφει κάθε βήμα.

Πόροι#

Γενικοί κανόνες#

• Κάθε αίτημα εκτός από τη σύνδεση περιέχει την κεφαλίδα Authorization: Bearer <token>.
• Τα περισσότερα τελικά σημεία POST δέχονται πεδία φόρμας (application/x-www-form-urlencoded ή multipart/form-data). Η αποστολή κράτησης και η έναρξη πληρωμής αναμένουν σώμα JSON. Η σελίδα αναφοράς κάθε τελικού σημείου αναφέρει ποια μορφή ισχύει.
• Οι αποκρίσεις είναι JSON με την ένδειξη success. Τα σφάλματα επιχειρησιακών κανόνων επιστρέφονται επίσης ως HTTP 200· κρίνετε το αποτέλεσμα από το success και όχι από τον κωδικό κατάστασης.
• Οι ημερομηνίες έχουν τη μορφή YYYY-MM-DD, τα ποσά είναι συμβολοσειρές με δύο δεκαδικά ("965.00") και το νόμισμα προκύπτει από τις ρυθμίσεις του online καναλιού του ξενοδοχείου.
• Η παράμετρος hotelID πρέπει να συμφωνεί με το ξενοδοχείο στο οποίο δεσμεύεται το token.

Έκδοση#

Αυτή η τεκμηρίωση καλύπτει το HMS API V2. Νέα πεδία και τελικά σημεία μπορεί να προστεθούν χωρίς προειδοποίηση· γράψτε τον client σας ώστε να αγνοεί άγνωστα πεδία. Οι αλλαγές παρατίθενται στις σημειώσεις έκδοσης.

Επόμενα βήματα#