$ GUIDE · 12 MIN
Configurer votre jeton API Misterbooking Cloud
Prérequis
- Un compte administrateur Misterbooking Cloud
- Un compte MisterBookCloud actif avec au moins un module en attente d'activation
- Un navigateur récent (Chrome, Firefox, Edge, Safari version 15 ou plus)
Étape 1 — Ouvrir le panneau API dans Misterbooking
Connectez-vous à Misterbooking Cloud avec un compte disposant du rôle « Administrateur » ou « Directeur technique ». Rendez-vous dans le menu Paramètres → Intégrations → API partenaires. Cliquez sur Créer un jeton partenaire.
Étape 2 — Définir le périmètre
Nommez le jeton mbh-{module}-{date} (par exemple mbh-analyse-revenus-20260824) pour identifier facilement son usage. Sélectionnez le périmètre demandé par MisterBookCloud, qui est affiché dans la fiche du module :
- Lecture réservations — nécessaire pour tous les modules d'analyse
- Lecture tarifs et disponibilités — nécessaire pour le rate shopping
- Écriture tarifs — nécessaire pour les connecteurs OTA
- Écriture inventaire — nécessaire pour le channel manager étendu
Étape 3 — Restreindre l'IP source
Dans l'écran de création, cochez « Restreindre à une plage IP » et collez la plage IP MisterBookCloud affichée dans votre espace client (menu Sécurité → Empreintes réseau). Cette étape est facultative mais fortement recommandée.
Étape 4 — Générer et copier le jeton
Cliquez sur Générer. Le jeton s'affiche une seule fois — copiez-le immédiatement. Il commence par mbk_pk_live_ suivi de 48 caractères alphanumériques.
Étape 5 — Coller le jeton dans MisterBookCloud
Retournez dans votre espace client MisterBookCloud, ouvrez le module en attente, cliquez sur Connecter Misterbooking Cloud, collez le jeton, cliquez sur Valider. Un test de synchronisation automatique se déclenche et remonte un statut vert en 30 à 60 secondes.
Étape 6 — Vérifier le journal d'audit
Dans le menu Audit trail de votre espace client MisterBookCloud, vérifiez la présence d'un événement token.linked horodaté et associé au module concerné. Vérifiez également côté Misterbooking Cloud, dans Paramètres → Intégrations → Journal, la présence des premiers appels de MisterBookCloud sur le jeton créé.
Que faire en cas d'erreur
Si le test de synchronisation échoue, les codes d'erreur les plus fréquents sont : 401 invalid_scope (le périmètre du jeton ne couvre pas l'appel), 403 ip_blocked (la restriction IP n'inclut pas la plage MisterBookCloud), 429 rate_limited (un autre système utilise déjà le jeton). Contactez support@misterbookcloud.org avec l'identifiant d'incident affiché.