API Billetterie Mapado - Publier un événement pas à pas (API en écriture)

API Billetterie Mapado - Publier un événement pas à pas (API en écriture)

Dans ce guide, nous allons voir comment publier un événement complet (avec séance et tarif) dans la billetterie Mapado (appel en écriture).

Idea
Pour commencer, assurez-vous d'avoir déjà pris en main l'API en :
  1. Obtenant votre token d'authentification
  2. Ayant réussi un premier appel en lecture sur l'API

    Publier un événement

    L'API billetterie Mapado permet de réaliser à peu près tout ce que l'on souhaite, elle est toutefois très riche.
    Pour vous permettre de vous y retrouver, voici les endpoints dont vous aurez besoin pour publier un événement : 

    Liste des principaux endpoints pour la publication d'un événement

    1. /wallets

    Un wallet est utilisé pour distinguer des événements dans plusieurs devises. En général, vous en disposez d'un seul associé à votre devise principale.
    Vous avez besoin du wallet_id pour créer un événement

    1. /contracts
    C'est avec ce endpoint que vous pourrez obtenir votre numéro de contrat. Celui-ci est nécessaire pour certains endpoints
    Vous avez besoin du contract_id pour créer un lieu

    1. /venues
    C'est le endpoint qui permet de créer un lieu dans lequel se déroule un événement (nom du lieu, adresse, code postal, ville, pays).
    Il est recommandé de créer votre lieu une fois pour toutes et d'utiliser son identifiant pour chaque nouvel événement créé

    1. /ticketings
    C'est le endpoint qui permet de créer un événement (titre, description, visuels, lieu, ...)

    1. /event_dates
    C'est le endpoint qui permet de créer une ou plusieurs séances pour un événement. L'information principale à envoyer est la date de celle-ci.

    1. /taxes
    Ce endpoint est accessible en lecture seule et permet d'obtenir un identifiant de taux de TVA.

    1. /ticket_prices
    Ce endpoint permet de créer les tarifs associés à chaque séance. Il nécessite un identifiant de taxe en plus des informations classiques (nom du tarif, montant, ...)

    Timezone, Currency, Country_code ?

    L'API mapado fonctionne pour des événements se déroulant dans tous les pays, il est donc nécessaire lorsque vous publiez un événement d'indiquer dans quel pays vous vous trouvez.

    La timezone pour la France est "Europe/Paris", vous trouverez une liste des timezones sur wikipedia

    La devise pour l'Europe est "EUR", vous trouverez une liste complète des devises sur wikipedia

    Le code pays pour la France est "FR", vous trouverez une liste complète des codes pays sur wikipedia

    Identifiants longs

    L'API utilise des identifiants longs du type : "/v1/event_dates/146876".

    Notes
    Les appels en lectures (GET) sur l'API vous fournissent l'information dans ce format qu'il est simple d'utiliser ensuite en écriture (POST). Pensez-y

    Exemple de code fonctionnel

    Vous trouverez sur le lien ci-dessous un code complètement fonctionnel en Python qu'il sera simple d'adapter dans d'autres langages.


    Ajouter une image aux événements

    C'est le champ "mediaList" du endpoint /v1/ticketings qui permet d'associer une image à un événement (ticketing).
    Ce champ se présente sous la forme suivante :
    2. "mediaList": [
    3.     { "imageType": "image", "path": "2020/9/24/5f6cb105c6c56-1ter-alpha-kaba-1cirene-vignaud.jpeg" }
    4. ]
    Le "path" est obtenu dans le champ "imagePath" après l'upload d'une image à l'aide du enpoint dédié (voir ci-dessous).

    Publier une image

    La publication d'une image se fait par un POST sur le endpoint ci-dessous
    L'image est à spécifier dans le champ "file"

    Spécifier en headers : "Content-Type" : "multipart/form-data"

    Les paramètres width et height permettent de spécifier les dimensions d'une image redimensionnée au retour du POST (dans le champ "thumbPath"). Les proportions sont alors conservées.

    Le retour présente cette forme : 
    1. {    
    2.     "status": "success",
    3.     "imagePath": "2022\/7\/1\/62bef00d1c241-c040-places-sanpietroburgo.webp.jpeg",
    4.     "thumbPath": "\/\/img1.mapado.net\/2022\/7\/1\/62bef00d1c241-c040-places-sanpietroburgo.webp.jpeg_thumbs\/160-100.jpeg",
    5.     "width": 2048,
    6.     "height": 1536
    7. }


    Articles associés 
    1. API Billetterie Mapado Pro - Obtenir des clés d'API
    2. API Billetterie Mapado Pro - Faire un premier appel en lecture (GET) et comprendre les paramètres