Comment créer et utiliser un jeton API

Les jetons API permettent à un autre système de se connecter à votre compte TicketingHub. Vous devez disposer d’un accès administrateur pour les gérer.

À quoi peut servir un jeton API

?

• Envoyer les données TicketingHub vers un logiciel de reporting ou un entrepôt de données.
• Permettre à une plateforme partenaire personnalisée de consulter les produits et les tarifs.
• Créer une expérience de réservation côté serveur qui vérifie les disponibilités en temps réel.

Un jeton API ne crée pas de connexion intégrée à Google Sheets. Consultez Comment exporter les données TicketingHub et connecter d’autres outils pour choisir entre les exportations CSV, Zapier, les webhooks et l’accès à l’API.

Activer l’accès à l’API

1. Accédez à Paramètres → Fonctionnalités.
2. Activez Accès à l’API.

Il s’agit d’un paramètre libre-service. Après l’avoir activé, Jetons API apparaît dans les paramètres.

Créer un jeton

1. Accédez à Paramètres → Jetons API.
2. Sélectionnez Générer un jeton API.
3. Saisissez un nom permettant d’identifier le système qui utilise le jeton.
4. Choisissez Supplier API (V2) pour la gestion des fournisseurs, Widget API pour les disponibilités et les réservations, ou OCTO API pour connecter des systèmes compatibles avec la norme OCTO.
5. Si vous avez choisi Supplier API (V2) ou OCTO API, vous pouvez sélectionner Lecture seule lorsque l’intégration doit uniquement consulter les données. Cette option ne s’applique pas aux jetons Widget API.
6. Ajoutez une date d’expiration si nécessaire, puis générez le jeton.
7. Copiez immédiatement le jeton et conservez-le en lieu sûr. Le jeton complet ne s’affiche qu’une seule fois.

Utiliser le jeton

Envoyez le jeton dans l’en-tête Authorization de chaque requête API�a0:

Authorization: Bearer YOUR_TOKEN

Utilisez les jetons API uniquement dans des systèmes sécurisés côté serveur. N’insérez pas de jeton dans le code d’un site web, les e-mails, les messages de discussion ou les documents partagés.

Révoquer un jeton

Accédez à Paramètres → Jetons API et sélectionnez Révoquer à côté du jeton. La révocation prend effet immédiatement�a0; le système connecté cessera donc de fonctionner jusqu’à ce qu’il utilise un jeton de remplacement.

Créez un jeton distinct pour chaque intégration, accordez uniquement les accès dont elle a besoin et révoquez les jetons qui ne sont plus utilisés. Pour les mises à jour déclenchées par des événements, vous pouvez préférer les webhooks ou l’intégration Zapier.