Les identifiants API sont comme un nom d'utilisateur et un mot de passe qui permettent à 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. Un identifiant ne fait que lire : rien de ce que vous connectez ainsi ne peut modifier quoi que ce soit dans Amenitiz.

Vous les utiliserez si vous souhaitez connecter Amenitiz à un outil externe, ou si un développeur crée une intégration pour votre établissement. Vous découvrez l'API ? Commencez par Comment comprendre l'API Amenitiz.

Avant de commencer

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

Pour créer des identifiants API, vous devez être sur le plan Advanced et être le propriétaire du compte. Les membres de l'équipe ne peuvent pas créer ni gérer d'identifiants.

Gardez votre mot de passe Amenitiz à portée de main : il vous sera demandé pour terminer.

Étape par étape

Allez dans Paramètres.
Ouvrez Identifiants API.
Cliquez sur Nouvel identifiant.
Donnez-lui un nom que vous reconnaîtrez plus tard, par exemple l'outil que vous connectez, comme « Export comptable ».
Dans Que peut-il lire ?, ne cochez que ce que l'outil vous a demandé — vous devez cocher au moins un élément. Vous pourrez le modifier plus tard.
Si vous avez plusieurs établissements, cochez ceux que l'identifiant couvre dans Quels établissements ?. Avec un seul établissement, il n'y a rien à choisir.
Cliquez sur Créer l'identifiant.
Saisissez votre mot de passe Amenitiz lorsque Vérifions que c'est bien vous s'affiche, puis cliquez à nouveau sur Créer l'identifiant.
Copiez le Client ID et le secret, ou cliquez sur Télécharger sous forme de fichier pour les enregistrer.
Cliquez sur Terminé.

📌 Remarque

Rien à mémoriser. Si vous perdez le secret, rouvrez l'identifiant et Amenitiz vous le montrera après avoir vérifié votre mot de passe.

Vous pouvez maintenant transmettre le Client ID et le secret à votre développeur, ou les coller dans l'outil que vous connectez.

Choisir ce qu'un identifiant peut lire

Un identifiant ne lit que ce que vous cochez : ne cochez donc que ce que l'outil vous a demandé. Les six options sont :

Types de chambres et chambres : les informations de votre établissement, vos types de chambres et les chambres qui les composent.
Tarifs et offres : plans tarifaires, extras, promotions et conditions de vente.
Calendrier de disponibilité : jour par jour, ce qui est libre, le prix et toute durée de séjour minimale.
Réservations et informations client : réservations, charges et paiements, y compris le nom, l'e-mail, le téléphone et l'adresse de chaque client, et tout ce qu'il a écrit dans ses demandes.
Notes, factures et versements : les notes, factures et avoirs que vous avez émis, y compris les informations de facturation de vos clients, et votre compte de versement.
Paramètres de l'établissement et équipe : heures d'arrivée et de départ, e-mails automatisés, ainsi que les noms, e-mails et autorisations de votre équipe.

🚫 Avertissement

Les trois dernières options couvrent des données personnelles et sensibles. Vos clients n'ont jamais accepté de partager leurs informations avec l'outil que vous connectez : vous décidez à leur place. Ne cochez Réservations et informations client, Notes, factures et versements et Paramètres de l'établissement et équipe que si l'outil en a vraiment besoin.

Gérer vos identifiants

En ouvrant un identifiant, vous pouvez :

Copier le Client ID.
Afficher le secret pour le revoir, et le Masquer une fois terminé.
Remplacer le secret par un nouveau. Faites-le si vous pensez que votre secret a été partagé ou divulgué. Le Client ID reste le même, seul le secret change, et tout outil utilisant encore l'ancien secret perd l'accès jusqu'à ce que vous y colliez le nouveau.
Révoquer l'identifiant pour le désactiver définitivement. Amenitiz vous demande de saisir le nom de l'identifiant pour confirmer, puis tout outil qui l'utilise perd l'accès immédiatement.
Modifier ce que l'identifiant peut lire, en cochant ou décochant les six mêmes options, et modifier les établissements qu'il couvre.

⚠️ Important

Amenitiz vous demande de confirmer le mot de passe de votre compte avant d'afficher ou de remplacer un secret. Le secret donne accès aux données de votre établissement : nous vérifions donc que c'est bien vous.

📌 Remarque

Retirer un accès s'applique immédiatement et l'outil est déconnecté jusqu'à sa prochaine connexion. Ajouter un accès ne l'atteint que lors de sa prochaine connexion.

Garder vos identifiants en sécurité

Traitez le secret comme un mot de passe :

Ne le partagez jamais publiquement et ne l'envoyez pas par e-mail ou messagerie non sécurisés.
Ne le donnez qu'à des outils et à des personnes de confiance.
Si vous pensez qu'il a été exposé, remplacez-le immédiatement.

Pour les développeurs

La documentation technique complète se trouve sur developers.amenitiz.com.

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.

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.

Un membre de l'équipe peut-il créer des identifiants API ?

Non. Seul le propriétaire du compte peut créer un identifiant, afficher ou remplacer un secret, ou révoquer un identifiant.

J'ai perdu mon secret. Que faire ?

Ouvrez l'identifiant et cliquez sur Afficher, puis confirmez le mot de passe de votre compte. Rien n'est perdu : vous ne devez remplacer le secret que si vous pensez que quelqu'un d'autre l'a vu.

Puis-je modifier ce qu'un identifiant peut lire après l'avoir créé ?

Oui. Ouvrez l'identifiant et cochez ou décochez les options. Retirer un accès s'applique immédiatement ; ajouter un accès atteint l'outil lors de sa prochaine connexion.

Dois-je créer un identifiant par outil ?

Oui. Un identifiant distinct par outil vous permet d'en remplacer ou d'en révoquer un sans couper les autres, de ne donner à chaque outil que l'accès dont il a besoin, et de voir d'un coup d'œil à quel outil correspond chaque identifiant.

J'ai révoqué un identifiant par erreur. Puis-je le réactiver ?

Non. La révocation est définitive. Créez un nouvel identifiant et transmettez le nouveau Client ID et le nouveau secret à l'outil ou au développeur.

Comment créer et gérer vos identifiants API