Glossaire

Le vocabulaire de la plateforme, et la correspondance entre les termes français de cette documentation et les noms anglais des champs de l'API.

Français	API / code	Définition
Plan	chart, chartId	La carte d'une salle : sièges, rangées, zones. Réutilisable d'un événement à l'autre
Événement	event, eventId	Une occurrence datée sur un plan. Porte les statuts de sièges
Identifiant textuel	identifier	Slug unique d'un événement, utilisable à la place de l'UUID
Siège	seat, seatKey, seatId	Une place. Sa clé (PARTERRE-A-12) est stable tant que la section n'est pas renommée — formes détaillées
Catégorie	category, catId	Regroupement de sièges par tarif ou zone. Porte un nom, une couleur, un tarif
Blocage temporaire	hold	Réservation provisoire d'un siège pendant un achat en cours
Réservation ferme	book	Vente définitive d'un siège
Libération	release	Retour d'un siège à l'état disponible
Session	session	Panier côté serveur. Produit sessionToken et holdToken
Espace de travail	workspace	Votre compte : plans, événements, clés, membres
Clé publique	workspaceKey, pk_live_ / pk_test_	Clé en lecture seule, exposable dans le navigateur
Clé secrète	keyId:secret	Clé en écriture, serveur uniquement
Jeton d'embed	embed-token	Jeton court utilisé par l'éditeur embarqué

Statuts d'un siège

Statut	Signification
available	Libre, sélectionnable
hold	Bloqué temporairement
booked	Réservé fermement
canceled	Retiré de la vente

Statuts d'un plan

Statut	Signification
draft	En cours de dessin, inutilisable par un événement
published	Publié, associable et affichable
archived	Retiré de la circulation

Le drapeau pendingChanges (booléen, distinct du statut) signale un plan publié modifié depuis.

Portées de clé

Portée	Valeur	Droits
Publique	PUBLIC	Lecture, pose de holds via le widget
Back-office	BACKOFFICE	Lecture et écriture complètes