L'API ouverte de Guesty est une API REST qui offre une solution polyvalente pour intégrer vos systèmes à votre compte Guesty. Elle utilise des jetons d'accès OAuth 2.0 pour authentifier les requêtes, garantissant ainsi une autorisation sécurisée et fiable. OAuth 2.0 est une méthode d'autorisation sécurisée et standard qui assure un accès sécurisé aux données utilisateur grâce à des jetons chiffrés, sans exposer l'identité ni les informations d'identification de l'utilisateur. Pour plus d'informations, consultez notre documentation API et les détails relatifs aux limites de tarif de l'API Guesty.
L'API ouverte de Guesty vous permet, ainsi qu'à votre équipe, d'intégrer les informations d'authentification des voyageurs à tout service, outil ou système. De plus, nos données analytiques fournissent des données en temps réel sur l'utilisation de votre API, vous aidant ainsi à surveiller et à optimiser vos intégrations.
Suivez les instructions ci-dessous pour enregistrer une nouvelle application. Vous pouvez la supprimer à tout moment.
Note :
Vous pouvez créer jusqu'à cinq (5) applications Open API OAuth.
Créer une paire de clés API
Lorsque vous enregistrez une application, vous recevez un identifiant d'application et un secret d'application, qui peuvent être utilisés lors d'appels API nécessitant l'identification de l'application.
Pas à pas:
- Connectez-vous à votre compte Guesty.
- Dans le menu de navigation latéral, cliquez sur
Intégrations pour ouvrir le menu déroulant. - Sélectionnez les applications OAuth.
- En haut à droite, cliquez sur Nouvelle application.
- Saisissez le nom et la description de l'application, puis cliquez sur Enregistrer. Ces champs sont obligatoires.
-
Cliquez sur
à côté de la clé correspondante et collez-la dans un endroit sûr pour consultation ultérieure.Important:
Votre identifiant d'application et votre clé secrète d'application ne sont visibles que lors de votre premier accès, après quoi Guesty les masque pour des raisons de sécurité.
Supprimer la paire de clés API
Pour supprimer une application, ainsi que son ID voyageur et son secret voyageur, cliquez sur 
à droite de l'application concernée et confirmez l'action dans la fenêtre contextuelle. Cette action est irréversible.
Utilisation du tableau de bord des données analytiques de l'API ouverte de Guesty
Le tableau de bord des données analytiques des API ouvertes de Guesty offre une vue d'ensemble détaillée de l'utilisation et des performances de l'API de votre application. Cet outil vous permet de suivre des indicateurs clés tels que les taux de réussite des requêtes, les erreurs des voyageurs et les seuils de limite de tarif. Chaque section du tableau de bord fournit des informations précieuses, vous aidant à optimiser les appels d'API, à résoudre les problèmes et à garantir une intégration fluide avec les applications tierces.
Suivez les instructions pour accéder au tableau de bord de l'API ouverte de Guesty.
Pas à pas:
- Connectez-vous à votre compte Guesty.
- Dans le menu de navigation latéral, cliquez sur Intégrations pour ouvrir le menu déroulant.
- Sélectionnez Données analytiques OAuth.
Utilisation des webhooks côté client de Guesty
La section des webhooks de Guesty offre une interface centralisée pour gérer les webhooks, visualiser l'activité et résoudre efficacement les problèmes.
Note:
Le tableau de bord des webhooks ne prend actuellement pas en charge la gestion des abonnements aux webhooks. Vous pouvez vous abonner aux webhooks et les gérer uniquement via l'API ouverte. Pour gérer les abonnements aux webhooks, consultez le guide de l'API des webhooks.
Points d'extrémité
Surveillez régulièrement les points de terminaison pour garantir un faible taux d'erreur et résoudre rapidement tout problème. Consultez et gérez toutes les URL de webhook actives et leurs taux d'erreur respectifs.
Consulter les journaux pour une URL spécifique
Cliquez sur une URL de webhook pour accéder à des informations détaillées, notamment le secret de signature (la clé utilisée pour authentifier les requêtes de Guesty vers votre point de terminaison) et la possibilité de rejouer des événements de webhook individuels.
