Documentation API Misterbookingmod
L'API Misterbookingmod vous permet d'automatiser la gestion de vos modules Misterbooking depuis vos propres outils internes. Endpoints REST, authentification par jeton personnel, webhooks événementiels et SDK officiels JavaScript et PHP.
Vue d'ensemble
L'API Misterbookingmod est une API REST accessible à l'adresse https://api.misterbookingmod.org/v1. Toutes les requêtes doivent être signées par un jeton personnel généré depuis votre Espace client. Toutes les réponses sont au format JSON encodé en UTF-8. Le rate-limit est de 60 requêtes par minute par jeton, extensible sur demande pour les intégrateurs certifiés.
Authentification
Chaque requête doit inclure un en-tête Authorization: Bearer <votre_jeton>. Les jetons sont générés dans Paramètres → Développeurs de votre Espace client Misterbookingmod. Ils ont une durée de vie configurable (par défaut 90 jours) et peuvent être révoqués à tout moment.
Endpoints principaux
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /modules | Liste des modules Misterbooking actifs sur votre compte |
| GET | /modules/{id}/status | Statut opérationnel d'un module (synchronisé, erreur, en pause) |
| POST | /modules/{id}/sync | Force une synchronisation immédiate avec Misterbooking |
| GET | /invoices | Liste paginée de vos factures Misterbookingmod |
| GET | /webhooks | Liste des webhooks configurés |
| POST | /webhooks | Créer un nouveau webhook |
| DELETE | /webhooks/{id} | Supprimer un webhook |
Webhooks
Vous pouvez enregistrer une URL HTTPS de votre choix pour recevoir des notifications événementielles en temps réel. Les événements disponibles :
module.activated— module Misterbooking activé pour un comptemodule.paused— module suspendu pour défaut de paiement ou action volontairemodule.sync_failed— échec de synchronisation avec l'API Misterbookinginvoice.paid— facture Misterbookingmod acquittéeinvoice.failed— échec de prélèvement mensuel
Chaque webhook est signé HMAC-SHA256 avec le secret partagé fourni lors de la création. Vous devez valider la signature côté serveur pour vous prémunir des requêtes forgées.
SDK officiels
- JavaScript / Node.js :
npm install @misterofbook/sdk - PHP :
composer require misterofbook/sdk-php - Python :
pip install misterofbook(bêta)
Environnement de bac à sable
Un environnement de bac à sable (sandbox) est disponible à l'adresse https://sandbox.api.misterbookingmod.org/v1 pour vos tests d'intégration. Il utilise des données fictives et ne facture jamais de véritables prélèvements. Un jeton de bac à sable dédié peut être généré depuis Paramètres → Développeurs → Bac à sable.