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 de l'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 de l'API et les détails relatifs aux limites de tarif pour les appels API de Guesty.
L'API ouverte de Guesty vous permet, ainsi qu'à votre équipe, d'intégrer des informations d'identification de voyageur dans un service, outil ou système. De plus, nos données analytiques fournissent des informations 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.
Créer une paire de clés API
Lorsque vous enregistrez une application, vous recevez un identifiant de voyageur et un secret de voyageur, 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
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
à côté de la clé correspondante et collez-la dans un endroit sûr pour consultation ultérieure.Important :
Votre identifiant voyageur et clé secrète de voyageur 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 
. Cliquez à 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 voyageur et les seuils de limite de tarif. Chaque section du tableau de bord fournit des informations précieuses, vous aidant à optimiser les appels 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 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 d'extrémité pour garantir un faible taux d'erreur et pour 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 d'extrémité) et la possibilité de rejouer des événements de webhook individuels.
