Online Booking API
Συνδέει τη μηχανή κρατήσεων του ιστότοπου του ξενοδοχείου με το 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
Τεκμηρίωση#
Πρώτα βήματα
- ΕπισκόπησηΤι κάνει το Online Booking API, βασικό URL, σύνοψη ροής και γενικοί κανόνες.
- Γρήγορη εκκίνησηΛάβετε token με τα διαπιστευτήρια συνεργάτη σας και στείλτε το πρώτο σας ερώτημα δωματίων και τιμών.
- Έλεγχος ταυτότηταςΣύνδεση με apiKey / apiSecret, Bearer token, πλαίσιο ξενοδοχείου και διάρκεια ισχύος του token.
- Αιτήματα και αποκρίσειςΣώματα form και JSON, ο φάκελος success, σελιδοποίηση, μορφές ημερομηνιών και ποσών, κωδικοί κατάστασης HTTP.
- Κωδικοί σφαλμάτωνΤιμές message και errorCode, σφάλματα ελέγχου ταυτότητας και οδηγίες επανάληψης.