Introduction

Mitoera est une plateforme de plans de salle interactifs et de réservation de sièges. Vous dessinez une salle une fois, vous l'associez à autant d'événements que nécessaire, et vos clients choisissent leur place depuis votre site.

Trois briques sont à votre disposition, utilisables ensemble ou séparément :

Brique	Pour quoi faire	Où elle s'exécute	Clé utilisée
API REST	Piloter plans, événements, sièges et réservations	Votre serveur	Clé secrète
SDK serveur (JS/TS, PHP)	La même chose, avec des objets typés au lieu de fetch/cURL	Votre serveur	Clé secrète
Widget SeatingChart	Afficher le plan et laisser l'utilisateur choisir ses sièges	Navigateur	Clé publique
Éditeur ChartDesigner	Embarquer l'éditeur de plan dans votre back-office	Navigateur	Clé secrète

Comment les briques s'articulent

Le parcours classique d'une réservation met en jeu les trois côtés :

1. Votre back-end crée une session pour l'événement et transmet le sessionToken à la page.
2. Le widget affiche le plan, l'utilisateur sélectionne des sièges — le widget pose automatiquement un hold dessus (blocage temporaire).
3. L'utilisateur paie. Votre back-end confirme la réservation avec la clé secrète, ce qui bascule les sièges en booked.
4. Si l'utilisateur abandonne, le hold expire tout seul ou vous le libérez explicitement.

Le point important : le navigateur ne réserve jamais. Il ne fait que sélectionner et bloquer temporairement. Seul votre serveur, porteur de la clé secrète, transforme un hold en réservation ferme.

Par où commencer

• Vous découvrez la plateforme → Concepts puis Démarrage rapide
• Vous voulez intégrer vite → Démarrage rapide
• Vous cherchez une méthode précise → SDK ou Référence API
• Vous voulez tester sans toucher à la production → Mode sandbox

Adresses utiles

Ressource	URL
API	https://api.mitoera.com/api
Back-office	bo.mitoera.com
Widget (CDN)	https://bo.mitoera.com/mitoera-widget.js
Éditeur (CDN)	https://bo.mitoera.com/mitoera-editor.js