Cours 1 — Comprendre l'API Misterbooking
Durée : 45 minutes · Niveau : Débutant · Prérequis : accès administrateur à un compte Misterbooking.
Qu'est-ce qu'une API ?
Une API (Application Programming Interface) est un ensemble de règles techniques qui permettent à deux logiciels de dialoguer entre eux automatiquement. Dans le cas de Misterbooking, l'API permet à des logiciels tiers — comme les modules Misterbookingmod — de lire ou modifier les données de votre compte Misterbooking sans que vous ayez à ressaisir manuellement les informations.
Les endpoints principaux
L'API Misterbooking v2.4 expose des endpoints REST regroupés par ressource. Voici les plus courants :
/reservations— lecture et création de réservations/availability— consultation et blocage des disponibilités/rates— lecture et mise à jour des tarifs/rooms— consultation des types de chambres/guests— accès aux fiches clients/reports— extraction des rapports de gestion
Authentification par clé API
Toute requête à l'API Misterbooking doit inclure votre clé API dans l'en-tête Authorization. La clé est générée depuis Paramètres → Intégrations → Accès API dans votre compte Misterbooking. Nous vous recommandons de créer une clé dédiée par intégration tierce afin de pouvoir la révoquer indépendamment.
Limites de taux (rate-limiting)
Misterbooking applique un rate-limit d'environ 120 requêtes par minute par clé API. Les modules Misterbookingmod respectent scrupuleusement cette limite grâce à un système de backoff exponentiel. Si vous développez votre propre intégration, prévoyez un mécanisme équivalent pour éviter les erreurs 429.
Bonnes pratiques
- Ne stockez jamais votre clé API dans un fichier versionné publiquement (repo Git, dépôt de code).
- Utilisez des webhooks lorsque disponibles plutôt que du polling pour réduire la charge API.
- Journalisez chaque erreur d'appel API pour faciliter le diagnostic.
- Testez vos intégrations en environnement de bac à sable avant la mise en production.