À quoi sert l’API
L’API est une alternative aux widgets pour construire votre présence de vente en ligne. Là où les widgets sont des modules prêts à l’emploi à intégrer, l’API vous permet de bâtir votre propre site internet en récupérant directement les données Tourbiz : catalogue, disponibilités, réservations.
L’intérêt principal est d’obtenir un site entièrement maîtrisé dans son design et son parcours utilisateur, sans dépendre de l’apparence des widgets. C’est l’outil adapté aux tour-opérateurs et marketplaces qui souhaitent automatiser leurs flux avec un ou plusieurs partenaires.
La clé API
La gestion de l’API repose sur une clé d’authentification. Depuis le menu Vente en ligne › API, une clé est générée et affichée en haut de la page (au format tourbiztest_…).
Cette clé s’utilise de deux façons :
- Dans la documentation Swagger, via le bouton Authorize
- Dans les en-têtes HTTP de vos requêtes
La documentation et les endpoints
La documentation complète est disponible à l’adresse :
<https://www.tourbiz.net/api/v2/doc#/>
Elle est présentée au format Swagger et regroupe les endpoints en trois familles :
| Famille | Contenu |
|---|---|
| Supplier | Informations du prestataire |
| Products | Liste des produits, fiche produit, disponibilité, calendrier |
| Bookings | Création, confirmation, annulation, consultation et mise à jour des réservations |
Construire l’URL d’un appel
L’URL de base des appels s’obtient en retirant /doc#/ de l’adresse de la documentation :
<https://www.tourbiz.net/api/v2/>
On y ajoute ensuite le chemin de chaque endpoint, par exemple /products ou /availability.
Cocher les produits accessibles par l’API
Sur la page API, une section liste les produits disponibles et permet d’en ajouter, classés par prestataire, via une simple case à cocher.
⚠️ Point important : les widgets de réservation s’appuient eux aussi sur l’API. Vous devez donc cocher vos produits dans l’onglet API de Vente en ligne avant de pouvoir les sélectionner dans les widgets. Cette étape conditionne les deux modes de diffusion.
Cette sélection permet également d’éviter d’exposer via l’API des produits de back-office non destinés à la vente en ligne, comme les privatisations.
Les contenus exposés : Textes API et Images API
L’API expose aussi des contenus enrichis pour alimenter votre site personnalisé. Ces contenus se renseignent dans la fiche produit, en modification, via deux onglets dédiés.
Textes API
Dans l’onglet Textes, une section Textes API (distincte des textes produit standard) regroupe :
- Titre flux
- Description courte flux
- Contenu inclus / non inclus
Ces champs sont gérables par langue de traduction.
Images API
Dans l’onglet Images, une section Images API est distincte de l’image produit standard.
Ces contenus sont ainsi indépendants de ceux utilisés ailleurs dans le back-office.