Hotelbeds / HBX Group API Suite
rateKey doit être recopié entre opérations, sans interprétation de sa structure interne.
Pour quel besoin ? Distributeur qui souhaite intégrer plusieurs familles de prestations dans son propre parcours de réservation.
- Test conseillé : Vérifier pour chaque API contenu, disponibilité, confirmation, modification et service, puis distinguer environnement d’essai et contrat commercial.
En savoir plus
Autres points à examiner
- Socle classique pour agences, TO, DMC et OTAs qui veulent acheter du stock B2B.
- Prévoir certification, gestion des quotas et conditions commerciales par marché.
Faits, limites et références (3)
Limite : Bonnes pratiques Hotel Booking API. Un recontrôle terminé ne constitue pas encore une confirmation de réservation.
À demander : Ne pas extraire dates ou occupation en découpant cette chaîne.
Documentation principale · consultée le
Autres références pour ce périmètre
HBX : tarif RECHECK et confirmation · consultation du
Hotel Booking API distingue Hotels, CheckRates et Bookings et s’appuie sur Hotel Content API pour les contenus. Un tarif rateType RECHECK demande une actualisation du prix et de la disponibilité via CheckRates.
Portée : La reconfirmation tarifaire reste distincte du résultat de réservation et des conditions effectivement acceptées.
Hotelbeds : workflow hôtelier · consultation du
Le workflow distingue rateType RECHECK, qui nécessite CheckRate pour actualiser prix et disponibilité avant réservation, et BOOKABLE, pour lequel cette étape intermédiaire n’est pas nécessaire.
Portée : Workflow de la Booking API hôtels ; cette règle ne décrit pas les autres produits Hotelbeds.
Contrôles proposés pour ce périmètre
- Référence opaque
- À réunir : rateKey doit être recopié entre opérations, sans interprétation de sa structure interne.. Ne pas extraire dates ou occupation en découpant cette chaîne.
- Recontrôle ciblé
- À réunir : CheckRates est requis pour RECHECK ; pour BOOKABLE, il peut être utilisé pour une information complémentaire telle que RateComments.. Ne pas recontrôler systématiquement chaque résultat de recherche.
- Séquence
- À réunir : Le guide recommande un seul rateKey par CheckRates et interdit de lancer CheckRates en même temps que la réservation.. Analyser la réponse du recontrôle avant la demande de confirmation.
- Attente de réponse
- À réunir : Le délai d’attente de confirmation doit être réglé à au moins 60 secondes.. Prévoir cette attente dans le parcours et distinguer délai dépassé et réservation refusée.
- Recontrôle de plusieurs tarifs
- À réunir : Les bonnes pratiques demandent de ne pas mélanger des rateKeys RECHECK et BOOKABLE dans une même opération CheckRates ; un seul rateKey par recontrôle est recommandé.. Conserver une réponse identifiable par tarif, sans transformer un échec de lot en refus de toutes les offres du séjour.
- Origine du mapping hôtelier
- À réunir : Hotelbeds demande de ne pas constituer le mapping hôtelier depuis l’environnement d’évaluation ou de préproduction.. Identifier l’environnement et la source du référentiel avant d’utiliser les correspondances dans un projet réel.
Page publique accessible · contrôle du 05/11/2026 · Portée du contrôle
Données et contrôles d’intégration
Le workflow prévoit Availability puis Booking. Une offre signalée RECHECK passe par CheckRate pour réévaluer prix et disponibilité.
- Offre sélectionnée
- Conserver rateKey de la réponse applicable.
- Type de tarif
- Lire le signal RECHECK avant de choisir le parcours.
- Occupation
- Rapprocher chambres, adultes et enfants de la recherche.
Scénario proposé : Faire comparer les conditions avant et après CheckRate pour une chambre destinée à une famille.
Portée : Les exemples historiques de dates et de prix ne constituent pas des offres actuelles.
Contrôles éditoriaux proposés, à rejouer sur votre périmètre ; aucun appel à une API fournisseur ni test de réservation effectué.
RateKey et recontrôle hôtelier · consultation du 13/10/2026

