Centre d'aide Mapado

Bienvenue sur le centre d'aide Mapado

Comment pouvons-nous vous aider ?

API Mapado - Obtenir des clés d'API (token / jeton d'accès)

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, …)

Pour créer une clé d'API (jeton d'accès), il faut disposer d'un accès administrateur.

Rendez-vous dans Paramétrage / Droits d'accès puis Applications.

Créer une application

Il existe 2 types d'applications :

  • Les applications partenaires : des intégrations mises en place par Mapado vers des services tiers
  • Les applications privées : développées intégralement par vous à partir de l'API

Dans les deux cas, vous aurez besoin d'une clé d'API et de l'identifiant de votre contrat qui est visible en haut de page (de la forme /v1/contracts/xxxxxx (xxxxx étant votre numéro de contrat)

image.png

Connecter un partenaire

Les applications partenaires sont :

  • Arenametrix
  • Assistant déclaration (SACD, ...)
  • Covoiturage-simple
  • Delight
  • Heeds
  • Kios
  • Paris Cité
  • Passe ton billet
  • Pims
  • Reelax Tickets
  • Ticket Factory
  • Ticket Théâtre
  • Ticketac
  • Ticketswap

Si vous avez besoin d'une clé d'API pour l'un de ceux-ci, cliquez sur "Connecter un partenaire"

Choisissez ensuite le partenaire concerné et validez. L'application est créée.

Il suffit ensuite de copier le Jeton d'accès en cliquant sur le bouton à droite de celui-ci et de le transmettre au partenaire, à l'agence ou à l 'équipe technique

image.png

Vous aurez aussi besoin de transmettre au partenaire :

  • l'identifiant de votre contrat qui est affiché en tête de page et est commun à toutes les applications
  • l'identifiant du point de vente qui est affiché au niveau de l'application

Créer une application privée

Une application privée est une application développée par vous ou votre prestataire technique sur la base de la documentation d'API Mapado.

TIP

Accéder à la Documentation de l'API de billetterie Mapado Pro

Pour créer une application privée, cliquez sur "Créer une application privée" et remplissez les champs.

image.png

  • Le nom vous permet de vous y retrouver si vous avez plusieurs applications. Il est libre
  • L'url est l'url de votre site ou du site qui va utiliser l'API Mapado. Il permet à l'équipe Mapado d'effectuer des vérifications sur la bonne utilisation de l'API
  • Le rôle par défaut permet de limiter les droits de la clé d'API

WARNING

Nous vous recommandons de créer un rôle dédié à votre clé d'API en limitant au maximum les droits du rôle au besoin métier. Exemple : si vous avez uniquement besoin de lister les événements, n'octroyez pas le droit de créer des commandes. En cas de piratage de votre clé, le risque est diminué.