Utiliser l'API Misterbooking pour vos intégrations tierces

L'API Misterbooking v2.4 est une API REST publique documentée qui permet à des outils externes de lire et modifier les données de votre compte Misterbooking. Voici comment elle fonctionne, dans quels cas la mobiliser et les bonnes pratiques pour éviter les écueils courants.

Pourquoi utiliser l'API Misterbooking ?

Trois cas d'usage principaux justifient le recours à l'API Misterbooking :

1. Automatiser des tâches répétitives — récupérer les nouvelles réservations pour les injecter dans un CRM, extraire les rapports comptables quotidiens vers votre système ERP.
2. Étendre les fonctionnalités natives — ajouter un module de yield management avancé, un connecteur Airbnb, un portail pré-arrivée, comme le proposent les modules Misterbookingmod.
3. Fluidifier la migration de données — importer un historique legacy depuis Opera, Protel ou Cloudbeds dans un nouveau compte Misterbooking.

Structure des endpoints

L'API Misterbooking est organisée par ressources métier :

• GET /v2/reservations?from=2026-08-01&to=2026-08-31 — liste des réservations sur une période
• GET /v2/availability?room_type=DOUBLE&date=2026-08-15 — disponibilités par type de chambre
• PUT /v2/rates/{date} — mise à jour d'un tarif quotidien
• POST /v2/reservations — création d'une nouvelle réservation
• GET /v2/reports/night-audit?date=2026-08-15 — extraction du rapport night audit

Authentification et sécurité

Toute requête doit inclure votre clé API dans l'en-tête HTTP Authorization: Bearer <votre_cle>. La clé est générée depuis votre compte Misterbooking (Paramètres → Intégrations → Accès API) et peut être révoquée à tout moment. Nous recommandons vivement de créer une clé API dédiée par intégration externe, afin d'isoler les révocations en cas de compromission.

Rate-limiting et bonnes pratiques

Misterbooking applique un rate-limit d'environ 120 requêtes par minute par clé. Au-delà, vous recevez une erreur HTTP 429 « Too Many Requests ». Trois techniques permettent de rester sous ce plafond :

• Backoff exponentiel — en cas d'erreur 429, attendez 1s, puis 2s, 4s, 8s avant de retenter.
• Batch requests — regroupez les mises à jour tarifaires en batch de 30 dates au lieu de 30 appels unitaires.
• Webhooks — lorsque disponibles, préférez les webhooks entrants au polling continu (par exemple, événement reservation.created).

Cas concret — Sync bidirectionnelle avec Airbnb

L'Extension Sync Airbnb pour Misterbooking illustre parfaitement l'utilisation croisée des deux API. À chaque nouvelle réservation Airbnb, notre module :

1. Reçoit un webhook Airbnb reservation.created
2. Convertit les données au format Misterbooking (mapping des types de chambres, taxes, remises)
3. Bloque l'inventaire sur Misterbooking via PUT /v2/availability
4. Crée la réservation dans Misterbooking via POST /v2/reservations
5. Journalise l'opération dans le tableau de bord Misterbookingmod

Toute l'opération prend en moyenne 850 ms de bout en bout, avec un taux de réussite mesuré à 99,97 % sur 12 mois glissants.