L'API Amenitiz permet à un autre système de se connecter à votre compte Amenitiz et de lire les données de votre établissement : vos chambres, tarifs, disponibilité, réservations et factures.

Vous l'utiliserez si vous souhaitez connecter Amenitiz à un outil externe, ou si un développeur crée une intégration pour votre établissement. La mise en place est un travail technique : vous ou un développeur qui travaille avec vous devrez écrire du code.

Avant de commencer

L'API Amenitiz est en bêta et son déploiement est en cours, certains détails peuvent donc encore changer.

L'API est disponible uniquement sur le plan Advanced, et seul le propriétaire du compte peut créer ou gérer des identifiants API. Les membres de l'équipe ne le peuvent pas.

Ce que l'API peut lire

Lorsque vous créez un identifiant, vous choisissez ce qu'il a le droit de lire, parmi six domaines :

Types de chambres et chambres
Tarifs et offres
Calendrier de disponibilité
Réservations et informations client
Notes, factures et versements
Paramètres de l'établissement et équipe

Les trois derniers couvrent des données personnelles et sensibles : ne les cochez que si l'outil en a vraiment besoin.

Ce que l'API ne peut pas faire

Elle ne peut rien modifier dans votre compte. L'API se contente de lire les données. Les tarifs, la disponibilité, les réservations et les paramètres se modifient dans Amenitiz.
Elle ne couvre pas tout ce que vous voyez dans Amenitiz. Certaines données ne sont disponibles que dans la plateforme.
Amenitiz ne fournit pas d'assistance technique pour les implémentations de l'API. Il s'agit d'une intégration avancée proposée en libre-service.

Étape par étape

Pour démarrer :

Vérifiez que votre établissement est sur le plan Advanced et que vous êtes le propriétaire du compte.
Créez vos identifiants API dans Paramètres → Identifiants API. Amenitiz génère un Client ID et un secret.
Transmettez le Client ID et le secret à votre développeur, ou collez-les dans l'outil que vous connectez.
Orientez votre développeur vers la documentation technique sur developers.amenitiz.com.

Cette vidéo montre la procédure étape par étape :

📌 Remarque

Prêt à connecter un outil ? Consultez Comment créer et gérer vos identifiants API.

Ai-je besoin d'un développeur pour utiliser l'API ?

Dans la plupart des cas, oui. L'API est une interface technique : soit un développeur travaille avec vous, soit l'outil que vous connectez prend déjà en charge l'API Amenitiz. En revanche, vous n'avez besoin de personne pour créer les identifiants.

L'API peut-elle modifier mes tarifs, ma disponibilité ou mes réservations ?

Non. L'API se contente de lire les données. Toute modification de vos tarifs, de votre disponibilité, de vos réservations ou de vos paramètres doit se faire dans Amenitiz.

Quelle est la différence entre l'API et le Marketplace ?

Le Marketplace regroupe des connexions prêtes à l'emploi vers des outils avec lesquels Amenitiz travaille déjà, et vous les activez vous-même sans code. L'API sert à connecter un outil qui n'a pas de connexion prête à l'emploi, et elle demande du développement.

Je suis sur le plan Advanced mais je ne vois pas Identifiants API

Le déploiement de l'API est en cours, elle n'est peut-être pas encore arrivée sur votre compte. Vérifiez que vous êtes connecté en tant que propriétaire du compte, puis contactez notre équipe d'assistance.

Comment comprendre l'API Amenitiz