Online Booking API
Connecte le moteur de réservation du site web de l’hôtel à HMS : liste des chambres et des tarifs, disponibilités en calendrier, coupons, paiement et transmission des réservations.
- URL de base
https://test.hms.gen.tr- Authentification
- apiKey / apiSecret → jeton Bearer
- Format
- Réponses JSON · corps de requête en formulaire ou JSON
- Périmètre
- 8 ressources · 16 endpoints
Ressources#
Authentification
1 endpointL’accès à l’API Online Booking se fait avec des identifiants partenaire délivrés par HMS. L’endpoint de connexion échange apiKey et apiSecret contre u…
- POST
/external/public/login
Chambres et tarifs
2 endpointsDeux endpoints alimentent les résultats de recherche du moteur de réservation : la liste des chambres, qui renvoie les types de chambre vendables, les…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Réservation
1 endpointLa chambre, le type de pension et le tarif choisis par le client sont transmis à HMS dans une structure BookingPushRQ. Le même endpoint gère les annul…
- POST
/external/online/channel/booking
Paiement
3 endpointsListe les types de paiement acceptés par l’hôtel pour les réservations en ligne et lance l’étape de paiement pour le type choisi. La marche à suivre p…
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Coupon
1 endpointValide les coupons de réduction en ligne définis par l’hôtel dans le panneau. Appliquez la réduction de votre côté et envoyez les montants remisés lor…
- POST
/external/online/coupon/search
Forfaits et extras
1 endpointPrestations supplémentaires vendables avec une réservation : forfaits chambre (liés à un type de chambre) et forfaits généraux (transfert, dîner, spa)…
- GET
/external/stock/packages
Informations de l’hôtel
4 endpointsDonnées qui alimentent l’habillage des pages du moteur de réservation : coordonnées et localisation, liens vers les réseaux sociaux, textes de pied de…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 autre
Référentiels
3 endpointsListes statiques pour les options de formulaire : pays, devises et langues. Elles changent rarement et peuvent être mises en cache pendant une journée…
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Documentation#
Premiers pas
- Vue d’ensembleRôle de l’API Online Booking, URL de base, aperçu du flux et règles générales.
- Démarrage rapideObtenez un jeton avec vos identifiants partenaire et envoyez votre première requête de chambres et tarifs.
- AuthentificationConnexion avec apiKey / apiSecret, jeton Bearer, contexte hôtel et durée de validité du jeton.
- Requêtes et réponsesCorps en formulaire et en JSON, enveloppe success, pagination, formats de date et de montant, codes de statut HTTP.
- Codes d’erreurValeurs de message et errorCode, erreurs d’authentification et conseils pour les nouvelles tentatives.