Démo en ligne

API d'hébergement

Une API d'hébergements pour hôtels, appartements et locations de vacances

Une API d'hébergements amène tous les types de logement sur votre site de réservation : chambres d'hôtel, résidences de tourisme, maisons de vacances, auberges de jeunesse et chambres d'hôtes. Cette page explique les données d'un séjour, les règles qui distinguent les locations des hôtels et comment PHPTRAVELS vend vos propres établissements et le stock des fournisseurs dans une seule recherche.

  • Établissement, unité, tarif, calendrier
  • Séjour minimum et frais
  • Fenêtres d'annulation
  • Stock propre et offre via API

Le modèle de données

Quatre couches dans chaque séjour

Qu'il s'agisse d'un hôtel de 300 chambres ou d'une seule maison de plage, une API d'hébergement le décrit selon les mêmes quatre couches imbriquées. Chaque couche répond à une question que le client se pose avant de réserver.

01Établissement

Le lieu lui-même : nom, type, adresse et position sur la carte, photos, équipements, classement en étoiles ou en qualité, règlement intérieur et heures d'arrivée.

property_id · type · address · geo · photos · amenities · check_in_from

02Chambre ou unité

Ce qui est réellement réservé : un type de chambre, un appartement entier ou un lit en dortoir, avec sa surface, ses lits et sa capacité maximale.

unit_id · beds · size_m2 · max_adults · max_children

03Plan tarifaire

La façon dont cette unité est vendue : la formule repas, la politique d'annulation, les conditions de paiement et qui peut la réserver, par exemple le public ou les agents uniquement.

rate_plan_id · board · cancel_policy · payment · channel

04Disponibilité

Une ligne par nuit : le prix, les unités restantes, le séjour minimum et si l'arrivée ou le départ est autorisé ce jour-là.

date · price · units_left · min_stay · closed_to_arrival

Un bâtiment, une chambre, une étiquette de tarif et un calendrier dessinés comme des couches empilées d'une même annonce d'hébergement

PHPTRAVELS appelle son module d'hébergement Stays parce que le même modèle couvre bien plus que les hôtels. Un établissement contient des unités, une unité est vendue via un ou plusieurs plans tarifaires, et chaque plan a un calendrier nuit par nuit avec prix et disponibilité. Si ces quatre couches sont bien posées, un lit en dortoir, une suite d'hôtel et une villa de trois chambres entrent dans la même recherche et le même paiement.

Les fournisseurs nomment les couches différemment, et certains en fusionnent deux, mais la structure est toujours là. Le Hôtels y ramène chaque source, et le client voit une page cohérente.

Nuit par nuit

Le calendrier de disponibilité fait gagner ou perdre les séjours

Toute API d'hébergements finit dans un calendrier. La recherche ne renvoie un établissement que si chaque nuit du séjour demandé est libre, tarifée et autorisée par les règles de séjour.

Appartement deux chambres · Tarif standardNovembre 2026 · Prix par nuit
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Libre, tarifé par nuit
  • Déjà réservé
  • Fermé par le propriétaire
  • Séjour minimum à partir de cette arrivée
  • Arrivée impossible

Données illustratives, simplifiées

  • Les prix sont par nuitLe total du séjour est la somme de chaque nuit : un vendredi et un samedi au tarif week-end coûtent plus cher que deux jours de semaine. Les prix par jour et par saison se trouvent dans le calendrier, pas sur l'établissement.
  • Règles de séjour minimumUn minimum de trois nuits pour une arrivée le vendredi masque l'unité dans une recherche de deux nuits. Les locations utilisent ces règles bien plus que les hôtels, souvent plus strictes le week-end et en haute saison.
  • Arrivée ou départ impossibleUne nuit peut être réservable dans un séjour plus long, mais pas comme première ou dernière nuit. Les jours de rotation des maisons de vacances fonctionnent ainsi.
  • Nuits fermées et stop-sellLes propriétaires bloquent des dates pour leur usage ou pour des travaux, et un stop-sell retire aussitôt une unité de la vente. Une seule nuit fermée dans les dates demandées exclut l'unité des résultats.

Tous les séjours ne sont pas des hôtels

Hôtels, appartements et locations de vacances

Le modèle de données est commun, mais chaque type de séjour le remplit différemment. Voici les différences que votre parcours de réservation doit gérer quand vous vendez plus que des chambres d'hôtel.

Hôtels

Dont auberges de jeunesse et chambres d'hôtes

Ce qui est réservé
Un type de chambre avec de nombreuses chambres identiques, ou un lit en dortoir partagé.
Tarification
Un tarif par nuit, par chambre et par formule ; adultes ou enfants en plus peuvent le modifier.
Règles de séjour
Séjour minimum seulement aux dates de pointe ; la plupart des nuits se réservent seules.
Frais et cautions
Taxe de séjour, parfois des frais de villégiature payés sur place.
Arrivée
Réception ouverte 24 h/24 ou avec personnel ; les heures d'arrivée sur le bon d'échange suffisent.
Source typique
Bedbanks et grossistes, contrats directs, channel managers.

Résidences avec services

Appart'hôtels et appartements en ville

Ce qui est réservé
Un type d'unité, souvent avec cuisine et chambres séparées.
Tarification
Un tarif par nuit et par unité, avec des prix à la semaine ou au mois pour les longs séjours.
Règles de séjour
Les séjours minimums sont courants, et les longs séjours pèsent lourd dans la demande.
Frais et cautions
Des frais de ménage par séjour et une caution remboursable sont courants.
Arrivée
Les horaires de réception varient ; une arrivée tardive demande une boîte à clés ou un code.
Source typique
Channel managers, contrats directs et quelques grossistes.

Locations de vacances

Maisons, villas et chalets

Ce qui est réservé
Un logement précis. Il n'en existe généralement qu'un.
Tarification
Un tarif par nuit pour tout le logement, plus un supplément par personne au-delà d'un nombre de base.
Règles de séjour
Séjour minimum, jours de rotation fixes et dates sans arrivée sont la norme.
Frais et cautions
Frais de ménage, caution dommages remboursable et taxes locales, chacun affiché avant le paiement.
Arrivée
Instructions d'arrivée, adresse et contact sont envoyés avant l'arrivée, jamais sur la page publique.
Source typique
Propriétaires et gestionnaires de biens, en direct ou via un channel manager.

Vous vendez les logements de nombreux hôtes plutôt que vos propres contrats ? C'est une place de marché, traitée sur la page Portail BnB.

Fenêtres de la politique d'annulation

Une réservation, trois fenêtres d'annulation

Une politique d'annulation est une chronologie comptée à rebours depuis la date d'arrivée. Chaque fenêtre indique ce que le client récupère s'il annule pendant cette période.

RéservationArrivée
  1. 01 · Jusqu'à 14 jours avant l'arrivéeAnnulation gratuiteLe client annule et est remboursé intégralement. C'est l'échéance que les voyageurs cherchent en premier : affichez-la sous forme de date, pas de règle.
  2. 02 · De 14 à 3 jours avantPénalité partielleUne pénalité s'applique, souvent la première nuit ou un pourcentage du séjour. Les locations peuvent conserver la caution dans cette fenêtre.
  3. 03 · 3 derniers jours et non-présentationNon remboursableLe montant total est conservé. Les tarifs vendus comme non remboursables entrent dans cette fenêtre dès la réservation.
Fenêtres d'exemple ; chaque plan tarifaire a les siennes.
  • Par plan tarifaire, pas par établissementLe même appartement peut avoir un tarif flexible et un tarif non remboursable moins cher : la politique relève donc de la couche du plan tarifaire.
  • Dates dans le fuseau horaire de l'établissement« 14 jours avant » se compte depuis la date d'arrivée à l'endroit où se trouve l'établissement. Convertissez-le en date et heure claires sur la page et sur le bon d'échange.
  • La politique du fournisseur primeAvec du stock via API, vous ne pouvez pas offrir des conditions plus souples que celles du fournisseur. Avec vos propres contrats, vous fixez vous-même les fenêtres.

Stock propre et stock via API

Vos établissements sous contrat et les API fournisseurs dans une seule recherche

La plupart des vendeurs d'hébergement font les deux : ils chargent les lieux qu'ils contractent eux-mêmes et ajoutent des API fournisseurs pour tout le reste. Le voyageur ne doit jamais deviner d'où vient un séjour.

Vos propres établissements

  • Chargez vous-même établissements, unités et plans tarifaires dans l'admin
  • Donnez aux propriétaires et aux hôtels un accès extranet pour gérer leur calendrier
  • Définissez prix, séjours minimums, dates fermées et fenêtres d'annulation
  • Allotements avec jours de libération et stop-sell
  • Ou recevez tarifs et disponibilités d'un channel manager

Stock fournisseur via API

  • De grands catalogues dans des destinations que vous ne pourriez jamais contracter
  • Prix et disponibilités en direct au moment de la recherche
  • Formules, politiques et frais du fournisseur sur chaque tarif
  • Activé avec votre propre contrat et vos identifiants fournisseur
  • Réservation et annulation envoyées directement au fournisseur

Ce que reçoit le client

  • Une seule liste de résultats, avec une page par établissement
  • La même chambre issue de plusieurs sources affichée une fois, à votre prix
  • Vos marges par fournisseur, destination ou canal, et des tarifs agents B2B
  • Un seul format de bon d'échange, quelle que soit la source qui a confirmé

La connexion d'un channel manager est traitée sur Intégration de channel managers. Pour les chambres que vous détenez sous contrat, voir Système d'inventaire de réservations.

Prêt dans PHPTRAVELS

Fournisseurs d'hébergement déjà connectés

Ces fournisseurs d'hébergement sont déjà connectés au module Stays. Vous signez avec le fournisseur, saisissez vos propres identifiants dans l'admin, testez dans son sandbox et passez en production. La liste provient en direct de notre annuaire d'intégrations.

Il vous faut un fournisseur absent de la liste, comme un réseau régional de locations ? Toute API d'hébergement documentée peut être ajoutée, voir Intégration d'API sur mesure. Pour les types de fournisseurs hôteliers et le mappage des contenus, lisez la page API d'hôtels, ainsi que les guides des deux plus grands bedbanks : Intégration de l'API RateHawk et Intégration de l'API Hotelbeds.

Réservez un séjour comme le feront vos clients

Cherchez, comparez les tarifs et réservez dans la démo en direct, puis dites-nous quels établissements et fournisseurs vous comptez vendre.

Essayer la démoParlez-nous de vos fournisseurs

Vous créez votre propre application ou un flux partenaire ? La REST API de PHPTRAVELS sert toutes les sources d'hébergement connectées dans un seul format, avec des webhooks pour les événements de réservation. Elle est incluse dans l'offre Enterprise, voir Tarifs et la documentation développeur. La vue d'ensemble est sur API de voyage.

FAQ

API d'hébergements : les questions des développeurs et des agences

Parler à un conseiller

Une API d'hébergements est un ensemble de services web qui permet à un site de réservation de rechercher des hébergements, de lire prix et disponibilités pour des dates et des voyageurs donnés, et de créer, consulter et annuler des réservations. Elle couvre les hôtels et tous les autres types de séjour : appartements, locations de vacances, auberges de jeunesse et chambres d'hôtes.

Les appels de base sont les mêmes. Une API d'hébergements doit aussi gérer ce qu'exigent les séjours hors hôtel : réservation de l'unité entière, séjours minimums et jours de rotation, suppléments par personne, frais de ménage, cautions remboursables et instructions d'arrivée envoyées avant le séjour.

Oui. Dans PHPTRAVELS, le module Stays utilise un seul modèle d'établissement, d'unité, de plan tarifaire et de disponibilité pour tous les types d'hébergement : hôtels, appartements et maisons de vacances apparaissent dans la même recherche, chacun avec ses règles.

Chaque nuit du calendrier peut porter une durée minimale de séjour, généralement liée à la date d'arrivée. Si un client cherche moins de nuits que le minimum, l'unité n'est pas renvoyée. Les indicateurs d'arrivée et de départ impossibles fonctionnent de la même manière pour les jours de rotation.

Oui. Vous pouvez ajouter vous-même établissements, unités, plans tarifaires et calendriers, donner aux propriétaires un accès extranet ou recevoir les tarifs d'un channel manager, et les vendre à côté du stock fournisseur dans une seule liste de résultats.

Du plan tarifaire. Le stock fournisseur porte la politique du fournisseur, et vos propres établissements utilisent les fenêtres que vous définissez. L'échéance est affichée au client avant le paiement et imprimée sur le bon d'échange.

Non. Vous signez avec chaque fournisseur d'hébergement et saisissez vos propres identifiants dans l'admin. PHPTRAVELS fournit la plateforme de réservation, le module Stays et les connecteurs prêts à l'emploi.

Oui. Avec l'offre Enterprise, la REST API de PHPTRAVELS expose recherche et réservation sur toutes les sources connectées dans un seul format, avec des webhooks pour les événements de réservation et le code source complet pour l'étendre.

Une licence PHPTRAVELS, votre propre domaine et au moins une source de stock : des établissements que vous contractez vous-même, un channel manager ou un contrat fournisseur avec un grossiste en hébergement. La démo en direct montre d'abord le parcours complet.

Continuez à explorer

Plus sur la plateforme