Aller au contenu
Français

API pour les développeurs

PourquoiDonner au développeur de l’hôtel ou à un intégrateur un point de départ : ce qu’est cette API, où vit sa spécification et comment fonctionne l’accès.
Pour quiLe développeur qui connecte à HotelsCalendar son propre système ; au propriétaire — pour le montrer à un prestataire.
Ce que vous obtenezLa compréhension de la surface de l’API — quelles données elle permet d’atteindre — et du processus d’obtention de l’accès : un jeton et une URL de base.
LimitesC’est un point de départ, et non un répertoire des méthodes : la liste complète vit dans la spécification ; les limites techniques ne sont pas publiées.

HotelsCalendar a une API : les mêmes réservations, disponibilités et clients avec lesquels vous travaillez dans l’interface — mais programmatiquement. Cette page est un point de départ : ce qu’est cette interface, où vit sa spécification et comment obtenir l’accès. Il n’y a pas ici d’exemples avec du code — la spécification les remplace.

L’API est une interface programmatique au-dessus du produit. Elle rend et accepte les mêmes données que l’interface du PMS : les réservations, la disponibilité, les clients. L’interface est pour les personnes, l’API pour les programmes : un logiciel comptable, un script ou une feuille de calcul lit et change les données de l’hôtel sans transfert manuel.

Les données de l’API parlent la même langue que les articles de ce répertoire : des réservations avec leurs statuts et leurs clients, la disponibilité par dates, les données des clients. C’est pourquoi, avant de connecter un système, il est utile de comprendre comment le produit décrit ces entités — c’est par là que commence toute intégration.

La description complète de l’API est une spécification OpenAPI, le fichier openapi.yaml : elle liste toutes les méthodes — ce que chacune accepte et renvoie — et les modèles de données. La spécification est regroupée en environ 24 sections thématiques.

Elle s’ouvre et se télécharge via l’URL de base de l’API — l’adresse qui est délivrée en même temps que l’accès. C’est la source de vérité sur les capacités : tout ce qui y est décrit, l’API sait le faire ; ce qui n’y figure pas, l’API ne le promet pas.

L’accès à l’API passe par un jeton : une clé personnelle qui est transmise avec chaque requête. Grâce au jeton, l’API comprend de quel établissement vient la requête et ce qui est permis à cet accès.

Le jeton et l’URL de base arrivent ensemble — au moment de la connexion (comment la demander — plus bas). Traitez le jeton comme un mot de passe : il ouvre les données de l’établissement, c’est pourquoi il se conserve de votre côté et ne se publie pas.

  • Votre propre analytique. Les réservations s’exportent vers votre outil de BI ou votre feuille de calcul — et s’y comptent comme vous en avez besoin, sans export manuel chaque mois.
  • La synchronisation avec les systèmes internes. Le logiciel comptable ou le service de l’hôtel reçoit les réservations et les changements du PMS — et les données ne divergent pas d’un système à l’autre.
  • Les mini-services et les widgets. Un petit outil au-dessus des données de l’hôtel — une page interne pour le personnel, une synthèse pour le gestionnaire — qui prend les données du PMS directement.

Pour les trois scénarios, le chemin est un : obtenir un jeton, trouver les méthodes qu’il vous faut dans la spécification, connecter votre système.

  • Les limites techniques de l’API — la fréquence des requêtes, les volumes d’export — ne sont pas publiées dans cet article.
  • La liste des capacités, c’est la spécification seule : les méthodes et les modèles sont décrits par openapi.yaml, et l’article ne promet rien au-delà d’elle.
  • Comment l’API change avec le temps — la compatibilité des versions, l’ordre des notifications de changements — cette page ne le promet pas non plus : les conditions sont convenues au moment de la connexion.
  • Il n’y a pas ici non plus d’exemples pas à pas avec du code — la spécification joue leur rôle.
  1. Écrivez-nous via la page « Contacts » du site HotelsCalendar : décrivez la tâche — quel système se connecte et de quelles données il a besoin.
  2. Nous enverrons un jeton et l’URL de base de l’API.
  3. Ensuite — selon la spécification : trouvez les méthodes adaptées à votre tâche et connectez votre système.

Si la question ne concerne pas le développement, mais la configuration de l’hôtel — commencez par la page du support.

  • Support et contacts — où et comment écrire à l’équipe : c’est par le support que commence aussi l’accès à l’API.
  • Glossaire des termes hôteliers — les termes de l’hôtellerie que vous rencontrerez dans les données : réservation, disponibilité, tarif, check-in.