Conventions de l'API

L'API Mitoera est une API REST : des URLs de ressources, des verbes HTTP, du JSON dans les deux sens.

https://api.mitoera.com/api

Authentification

Authentification HTTP Basic, keyId en identifiant et secret en mot de passe.

Authorization: Basic {base64(keyId:secret)}

curl https://api.mitoera.com/api/charts \
  -u pk_xxxxxxxx:sk_xxxxxxxx

Les endpoints de cette référence exigent tous une clé secrète. La clé publique ne sert qu'au widget, qui appelle des routes /api/widget/** dédiées. Voir Clés API.

Environnements

Une seule URL pour les deux environnements : c'est le préfixe de la clé qui décide.

Clé	Instance
pk_live_…	Production
pk_test_…	Sandbox

Voir Mode sandbox.

Format des échanges

Requêtes — corps en JSON, avec Content-Type: application/json pour tout POST, PUT et PATCH.

Réponses — toujours du JSON. Un objet pour une ressource, un tableau pour une collection.

Identifiants — des UUID sous forme de chaînes : 01926a3f-1234-7abc-8def-000000000001. Les événements ont en plus un identifier textuel unique.

Dates — format ISO 8601 UTC : 2025-01-15T10:00:00Z.

Verbes utilisés

Verbe	Usage
GET	Lire une ressource ou une collection
POST	Créer, ou déclencher une action (/publish, /hold, /book)
PUT	Remplacer les champs d'une ressource
PATCH	Modifier partiellement (statuts de sièges)
DELETE	Supprimer

Erreurs

Le code HTTP porte le sens, le corps porte le message :

{
  "error": "Le nom est requis"
}

Le tableau complet est sur Codes d'erreur.

Périmètre d'une clé

Une clé appartient à un workspace, et ne voit que les ressources de ce workspace. Aucun paramètre workspaceId à passer : le filtrage est implicite. Tenter d'atteindre une ressource d'un autre workspace renvoie 403, jamais 404 — la distinction évite de deviner l'existence de ressources voisines.

Les ressources

Ressource	Ce qu'elle représente	Page
Plans	La carte d'une salle et ses sièges	Plans
Événements	Une date sur un plan	Événements
Réservations	Le cycle hold → book → release	Réservations
Catégories	Tarifs et zones	Catégories

Plutôt qu'écrire ces appels à la main

Les SDK enveloppent tous ces endpoints avec des objets typés et gèrent l'authentification pour vous.