Vue d’ensemble
L’API Online Booking relie le moteur de réservation du site web d’un hôtel au logiciel hôtelier HMS. Liste des chambres et des tarifs, disponibilités en calendrier, validation des coupons, étape de paiement et transmission de la réservation à HMS : tout passe par cette API. Elle s’adresse aux agences qui développent des moteurs de réservation et aux partenaires HMS.
URL de base#
Tous les endpoints se trouvent sous l’URL de base ci-dessous, dans le chemin /external/…. Seul HTTPS est accepté.
https://test.hms.gen.trLe flux en bref#
POST /external/public/loginPOST /external/online/roomTypePOST …/payment/type/{type}POST …/channel/bookingLe jeton obtenu à la connexion est valable 7 jours et lié à un seul hôtel. La liste des chambres renvoie les chambres vendables et leurs prix pour les dates et l’occupation recherchées par le client ; une fois le choix fait et le type de paiement réglé, la réservation est enregistrée dans HMS sous forme de BookingPushRQ. Le guide Flux de réservation détaille chaque étape.
Ressources#
| Ressource | Endpoints |
|---|---|
| Authentification | POST /external/public/login |
| Chambres et tarifs | POST /external/online/roomTypeGET /external/room/type/hotel/availability |
| Réservation | POST /external/online/channel/booking |
| Paiement | GET /external/online/payment/typeGET /external/payment/companyPOST /external/online/payment/type/{paymentType} |
| Coupon | POST /external/online/coupon/search |
| Forfaits et extras | GET /external/stock/packages |
| Informations de l’hôtel | GET /external/hotel/{hotelID}/contact/infoGET /external/online/social/mediaGET /external/online/footerGET /external/online/mail/host |
| Référentiels | POST /external/countiesGET /external/currenciesGET /external/languages |
Règles générales#
- Toutes les requêtes, sauf la connexion, portent un en-tête
Authorization: Bearer <token>. - La plupart des endpoints
POSTattendent des champs de formulaire (application/x-www-form-urlencodedoumultipart/form-data). La transmission de la réservation et le lancement du paiement attendent un corps JSON. La page de référence de chaque endpoint précise lequel. - Les réponses sont en JSON et contiennent un champ
success. Les erreurs métier sont elles aussi renvoyées en HTTP200: jugez le résultat d’aprèssuccess, et non d’après le code de statut. - Les dates sont au format
YYYY-MM-DD, les montants sont des chaînes à deux décimales ("965.00") et la devise provient des paramètres du canal en ligne de l’hôtel. - Le paramètre
hotelIDdoit correspondre à l’hôtel auquel le jeton est lié.
Version#
Cette documentation couvre l’API HMS V2. De nouveaux champs et endpoints peuvent être ajoutés sans préavis ; écrivez votre client de sorte qu’il ignore les champs inconnus. Les modifications sont répertoriées dans les notes de version.