DOCUMENTATION

Développeurs

Intégrez la réservation Mastro sur votre site web en quelques lignes de code.

Widget de réservation

Trois méthodes d'intégration pour tous les cas d'usage

1

Ajoutez le script

Incluez le SDK Mastro dans le <head> ou avant la fermeture du <body> de votre page.

<script src="https://resa.mastro.app/sdk/mastro-booking.js"></script>
2

Initialisez le widget

Appelez MastroBooking.init() avec votre slug pour afficher un bouton de réservation.

<script>
  MastroBooking.init({
    slug: 'votre-slug',
    buttonText: 'Réserver un VTC',
    theme: 'light',
  });
</script>
3

Personnalisez

Consultez le tableau des options ci-dessous pour adapter le widget à votre site.

Référence des options

OptionTypeDéfautDescription
slugstringIdentifiant unique de votre page de réservation. Visible dans l'URL de votre page Mastro.
buttonTextstring'Réserver'Texte affiché sur le bouton flottant généré par le SDK.
theme'light' | 'dark''light'Thème visuel du widget. S'adapte automatiquement à votre site.
targetstring | nullnullSélecteur CSS d'un élément existant. Si défini, le formulaire s'insère dans cet élément au lieu d'ouvrir un modal.

Événements

mastro-booking-complete

Écoutez cet événement postMessage pour réagir lorsqu'un client termine sa réservation. Utile pour le suivi analytique, les redirections ou les confirmations personnalisées.

window.addEventListener('message', (event) => {
  if (event.data?.type === 'mastro-booking-complete') {
    console.log('Réservation confirmée :', event.data.booking);
  }
});

API REST

BIENTÔT DISPONIBLE

API REST Mastro

Accédez programmatiquement aux réservations, courses, factures et clients. Authentification par clé API, réponses JSON paginées.

Besoin d'aide ?

Notre équipe technique est disponible pour vous accompagner dans l'intégration.