API Regiondomod
Accès programmatique complet à votre compte Regiondomod : catalogue de tours, disponibilités, tarifs, réservations, guides, ressources et rapports. Pour les opérateurs qui veulent brancher Regiondomod à leur site sur mesure, leur application mobile ou leur système interne.
URL de base
https://api.regiondomod.org/v1
Authentification
Toutes les requêtes nécessitent un en-tête Authorization: Bearer <api-key>. Les clés API sont générées depuis votre Espace pro et portent le même niveau d'accès que le compte propriétaire. Vous pouvez générer plusieurs clés (staging, production, application mobile) et les révoquer indépendamment.
Endpoints principaux
| Endpoint | Méthode | Description |
|---|---|---|
/tours | GET | Lister tous les tours du catalogue avec pagination |
/tours/{id} | GET | Récupérer une fiche tour complète (photos, descriptions localisées, tarifs) |
/tours | POST | Créer un nouveau tour ou activité |
/tours/{id} | PATCH | Modifier une fiche tour existante |
/availability | GET | Consulter les disponibilités par tour et par période |
/availability | POST | Créer un nouveau créneau de disponibilité |
/bookings | GET | Lister les réservations avec filtres (canal, statut, date) |
/bookings/{id} | GET | Détail complet d'une réservation (client, add-ons, waivers) |
/bookings | POST | Créer une réservation depuis un système externe |
/bookings/{id}/cancel | POST | Annuler une réservation avec règle de remboursement |
/resources | GET | Lister guides, chauffeurs, véhicules et équipements |
/resources/{id}/schedule | GET | Planning d'une ressource sur une période |
/reports/revenue | GET | Rapport de chiffre d'affaires avec ventilation TVA |
/reports/channels | GET | Répartition CA et volumes par canal de distribution |
/vouchers | POST | Émettre un bon cadeau ou un code promotionnel |
Limites de débit
L'API est limitée à 120 requêtes par minute et par clé API, avec un quota mensuel de 100 000 requêtes inclus dans l'extension API Custom. Une réponse HTTP 429 est renvoyée en cas de dépassement, avec l'en-tête Retry-After indiquant le délai avant nouvelle tentative. Des quotas étendus sont disponibles sur demande pour les opérateurs à fort volume.
Webhooks événementiels
Configurez une ou plusieurs URL de webhook depuis votre Espace pro pour recevoir des notifications temps réel. Chaque événement est livré en HTTP POST avec un corps JSON et signé HMAC-SHA256 (en-tête X-Regiondomod-Signature) pour vérification côté récepteur.
| Événement | Déclencheur |
|---|---|
booking.created | Nouvelle réservation confirmée (tous canaux) |
booking.cancelled | Réservation annulée par le client ou l'opérateur |
booking.refunded | Remboursement traité par la passerelle de paiement |
ticket.validated | QR-code validé par le guide sur le terrain |
waiver.signed | Décharge de responsabilité signée par un participant |
customer.created | Nouveau client ajouté à la base |
availability.updated | Modification de disponibilité (création ou clôture) |
Environnement bac à sable
Un environnement de test est disponible à https://sandbox.regiondomod.org/v1 avec un compte pré-rempli (catalogue exemple, réservations fictives). Utilisez la clé API sandbox depuis votre Espace pro pour tester vos développements sans impact sur vos données de production.
Documentation OpenAPI
Une spécification OpenAPI 3.1 complète est fournie avec le module API Custom. Elle peut être importée dans Postman, Insomnia, Swagger UI ou tout générateur de SDK compatible pour produire automatiquement des clients dans le langage de votre choix.
Contact développeurs
Questions sur l'API, aide à l'intégration, demande d'extension de quota : support@regiondomod.org en précisant « API » dans l'objet.