Utiliser l'API Regiondomod pour vos intégrations internes

L'API Regiondomod donne à vos développeurs un accès contrôlé aux données de réservation, aux disponibilités, aux tarifs par créneau et aux profils clients de votre compte opérateur. Cet article détaille les principes de connectivité, les cas d'usage typiques pour les agences réceptives et la manière dont les webhooks permettent une architecture événementielle propre.

Authentification et clés API

L'API Regiondomod utilise une authentification par clé API générée depuis votre espace opérateur (Paramètres → Intégrations → Accès API). Chaque clé est associée à un compte opérateur et peut être limitée à un ensemble de permissions : lecture des réservations, écriture des réservations, lecture des disponibilités, modification des tarifs, lecture des profils clients ou accès aux rapports.

Nous recommandons de créer une clé dédiée par intégration (une pour votre CRM, une pour votre BI, une pour votre outil de billetterie) plutôt que de partager une clé unique. Cette approche facilite la révocation ciblée en cas de compromission et rend les journaux d'accès lisibles. Chaque appel doit inclure la clé dans l'en-tête X-Api-Key et être transmis exclusivement en HTTPS.

Lire les réservations de vos tours

Le point d'entrée /reservations permet de récupérer les réservations sur une plage de dates de départ, filtrées par activité, guide ou canal d'origine. La réponse renvoie l'identifiant de réservation, le nom du client principal, le nombre de participants par catégorie tarifaire (adulte, enfant, senior), le créneau horaire, le point de rendez-vous, le statut de paiement et le canal ayant généré la vente (site direct, GetYourGuide, Viator, revendeur local).

Le cas d'usage le plus courant consiste à synchroniser quotidiennement ces réservations dans votre CRM interne pour construire une vue client unifiée : historique de participation, préférences linguistiques, restrictions alimentaires, points de fidélité. Un simple appel toutes les 6 heures suffit pour la majorité des opérateurs.

Gestion des disponibilités et tarifs par créneau

Le point d'entrée /availability gère les créneaux : nombre de places restantes, seuils de départ minimum, blocage manuel pour maintenance. Vous pouvez également pousser des grilles tarifaires dynamiques (tarifs saisonniers, promotions dernière minute, tarifs groupe) via /pricing.

Une utilisation typique : votre revenue manager pousse chaque lundi matin la grille tarifaire de la semaine suivante en tenant compte de la météo prévue et du remplissage constaté. L'API propage ensuite les modifications sur votre site direct et sur tous les canaux de distribution connectés (GetYourGuide, Viator, Musement, Regiondo) en moins de deux minutes.

Webhooks : architecture événementielle

Plutôt que de solliciter l'API par polling, vous pouvez enregistrer des webhooks sur les événements clés : reservation.created, reservation.cancelled, reservation.modified, tour.checked_in, refund.issued. Regiondomod déclenche alors un POST HTTP vers votre endpoint dès que l'événement se produit.

Les webhooks servent typiquement à déclencher immédiatement l'envoi d'un email de confirmation personnalisé, à mettre à jour un dashboard en temps réel, ou à informer un prestataire externe (guide freelance, transporteur, restaurateur partenaire) qu'un participant supplémentaire doit être pris en compte. Chaque payload est signé (HMAC-SHA256) pour garantir son origine.

Limites de débit et bonnes pratiques

Pour préserver la stabilité de la plateforme, Regiondomod applique une limite de 600 requêtes par minute par clé API. Un dépassement renvoie un code HTTP 429 avec un en-tête Retry-After indiquant le délai à respecter. Nous recommandons une stratégie de recul exponentiel : 1 seconde à la première 429, 2 secondes à la deuxième, 4 secondes à la troisième.

Regroupez vos appels quand c'est possible : préférez une requête /reservations?from=2026-08-01&to=2026-08-31 à trente appels individuels. Utilisez les webhooks pour les événements ponctuels et réservez le polling aux synchronisations planifiées.

Environnement de test et documentation

Chaque compte opérateur dispose d'un environnement bac à sable identique en structure à la production mais isolé. Utilisez-le pour tester vos intégrations sans risque de créer de vraies réservations. La documentation complète, les schémas OpenAPI et une collection Postman prête à l'emploi sont disponibles sur la page Documentation API.