Référence API MisterBookingHub
L'API MisterBookingHub expose les objets de vos modules via REST et GraphQL (module GraphQL Gateway). Cette référence couvre l'API REST v1.
Authentification
L'authentification se fait par jeton JWT signé RS256, transmis dans l'en-tête Authorization: Bearer <token>. Les jetons sont générés dans votre espace client MisterBookingHub, section Paramètres → API. Chaque jeton a une portée (scopes) configurable : read:analytics, write:config, admin. Rotation possible à tout moment sans interruption de service (délai de grâce de 24h sur l'ancien jeton).
Rate limits
1 000 requêtes par minute par jeton. 5 000 requêtes par minute par compte. Les dépassements retournent HTTP 429 avec un header Retry-After. Voir notre AUP pour les relèvements contractuels.
Endpoints principaux
GET /v1/modules — liste des modules actifs. GET /v1/reports/revpar — rapport RevPAR consolidé. POST /v1/rate-shopper/pull — force un rate shopping immédiat. GET /v1/reviews — liste des avis collectés par Reviews Central. POST /v1/widget/rules — création d'une règle de déclenchement Widget Conversion Directe.
Format des réponses
Toutes les réponses sont au format JSON, encodage UTF-8, dates au format ISO 8601. Les erreurs suivent le RFC 7807 (Problem Details). Pagination cursor-based : after=<opaque_cursor>, first=<n>.
Exemples curl
curl -H 'Authorization: Bearer $TOKEN' https://api.misterbookinghub.org/v1/modules — retourne la liste JSON des modules actifs avec leur statut et leur dernière synchronisation.