API Billetterie Mapado - Obtenir des clés d'API

API Billetterie Mapado - Obtenir des clés d'API

Pour utiliser l’API Billetterie Mapado Pro, vous devez disposer de clés d’API qui sont spécifiques à votre application (site web, application mobile, …)


Première étape : vous devez impérativement disposer d’un compte Mapado disposant de droits de billetterie

Cette étape ne peut être réalisée que par une personne disposant d'un accès administrateur, qui pourra octroyer des droits depuis son interface de gestion de droits.

Il faut avoir en tête qu'actuellement, les clés d'API qui seront créées disposent d'exactement les mêmes droits que l'utilisateur qui les crée.
Ainsi, si vous voulez une clé d'API qui ne peut que "consulter" (et pas "écrire") ou n'accéder à qu'une sélection d'événements (versus la totalité de vos événements), il faut créer au préalable un utilisateur avec ces restrictions-là, et vous connecter depuis ce compte pour l'étape suivante. Il vous faudra un email lié à cet utilisateur. 

Notes
Astuce : Si vous avez une adresse gérée par Google (Gmail / Workspace), Microsoft (Outlook / Hotmail / Live / MSN) ou Apple (iCloud), il est possible de créer des "Alias" en rajoutant un "+" dans l'adresse suivi d'un mot clé. Par exemple, si votre email est jean.gabin@gmail.com, vous pouvez disposer d'un alias jean.gabin+apipartenaireX@gmail.com et les emails qui arriveront aussi sur votre adresse classique. Vous pouvez ainsi disposer d'autant de sous comptes dédiés à des accès API spécifiques sur Mapado.

Cette astuce fonctionne peut être aussi avec votre prestataire d'email, essayez d'envoyer un email sur un tel alias pour le vérifier (si votre email est votreemail@votrestructure.com essayez d'envoyer un email à votreemail+test@votrestructure.com )


Deuxième étape : Créer une application

Connecté à Mapado avec ce compte (ou à votre propre compte si vous voulez une clé d'API avec tous les droits d'administrateur), rendez-vous ensuite sur votre espace pro Mapado ( https://desk.mapado.com/ ) puis en haut à gauche sur votre avatar (une icône de personnage neutre si vous n'avez pas d'avatar), rubrique « Mon compte » (vous pouvez aussi directement cliquer sur https://accounts.mapado.com/applications/ qui est un lien direct).

Cliquez sur « Voir ou modifier mes jetons d'applications » :


Puis, vous arriverez sur la page de gestion de vos applications : 



Notes
Si vous ne voyez pas le bouton, c'est que votre compte ne dispose pas des droits d'accès pour créer un accès à l'API Billetterie Mapado Pro.


Donnez alors un nom à votre application (quelque chose de clair pour vous y retrouver)
Donnez l’adresse URL du site qui utilisera les données de l'API. Si c'est pour un usage sans URL, vous pouvez mettre l'adresse de votre prestataire ou de votre site officiel.

Cliquez sur « Valider ».


Un bloc comme ci-dessous apparaît. Vous pouvez maintenant copier et utiliser le jeton d'authentification qui sera à utiliser pour vous connecter à l'API.