Vue d'ensemble
Lorsque vous ouvrez une page Intégration Marketplace dans Guesty pour une intégration déjà connectée, vous verrez un bouton intitulé « Afficher la clé API (jeton d'intégration) ». Cliquer sur ce bouton affiche le dernier jeton généré pour cette intégration.
Cet article explique à quoi sert ce jeton, pourquoi il expire et ce qu'il faut faire si vous devez en générer un nouveau.
À quoi sert le jeton d'intégration ?
Le jeton d'intégration (clé API) est utilisé uniquement pour la connexion/autorisation initiale entre Guesty et la plateforme partenaire. Une fois l'intégration établie, son rôle est terminé : il n'est plus nécessaire pour maintenir l'intégration en fonctionnement.
Pourquoi le jeton expire-t-il après 4 heures ?
Pour des raisons de sécurité, chaque jeton d'intégration expire automatiquement 4 heures après sa génération. Ce délai de 4 heures vous permet de copier le jeton et de le saisir sur le système de votre partenaire afin de finaliser la connexion.
Si vous consultez le jeton après l'expiration de ce délai de 4 heures, vous verrez un message indiquant que le jeton a expiré.
Important : Un jeton expiré ne signifie pas que votre intégration est déconnectée ou ne fonctionne pas. Cela signifie simplement que ce jeton n’est plus valide et ne peut plus être utilisé ou accepté par le partenaire. Cela n’a aucune incidence sur la connexion active entre Guesty et le partenaire.
Quand aurais-je réellement besoin d'un nouveau jeton ?
Vous n'avez besoin de générer un nouveau jeton d'intégration que si vous rencontrez activement un problème de connexion, par exemple :
- Vous configurez l'intégration pour la première fois et vous n'avez pas encore terminé de saisir le jeton côté partenaire, ou
- Le tableau de bord du partenaire affiche un message indiquant que l'intégration est déconnectée ou qu'une nouvelle clé API est requise.
Si votre intégration fonctionne normalement, un jeton expiré affiché sur cette page ne nécessite aucune action.
Comment générer un nouveau jeton d'intégration
Si vous avez besoin d'un nouveau jeton, suivez ces étapes :
- Accédez à la page d'intégration correspondante dans Guesty.
- Cliquez sur Déconnexion.
- Dans la fenêtre contextuelle, cochez la case pour confirmer que vous avez lu le message, puis cliquez sur Déconnexion
- Actualisez la page de force.
- Cliquez sur « Se connecter ». Guesty générera alors un nouveau jeton d'intégration.
- Copiez le nouveau jeton et saisissez-le dans le champ approprié de l'application du partenaire, ou partagez-le avec l'équipe d'assistance du partenaire si nécessaire.
Remarque : Le nouveau jeton expirera 4 heures après sa génération. Nous vous recommandons donc de finaliser la connexion côté partenaire dès que possible après sa génération.