Afficher les événements Fienta sur votre propre site

Afficher les événements

Vous pouvez afficher tous vos événements Fienta directement sur votre propre site. Avec un peu de programmation, vous pouvez mettre en forme et structurer la liste pour qu’elle s’harmonise avec le design et la structure de votre site.

API publique

Notre API publique suit le modèle REST, renvoie des réponses encodées en JSON et utilise les codes de réponse HTTP habituels.

Point de terminaison

Vous pouvez obtenir la liste des événements à venir, publiés et non privés, pour un organisateur donné via ce point de terminaison :

GET https://fienta.com/api/v1/public/events?organizer=<organiser_id>

<locale>
Deux lettres minuscules indiquant la langue préférée de l’événement. Les événements saisis dans d’autres langues seront tout de même renvoyés. Pour ne récupérer que les événements dans une langue précise, ajoutez le paramètre de requête « locale_strict ».

<organiser_id>
L’identifiant de l’organisateur sur Fienta. Vous le trouvez dans l’URL lorsque vous ouvrez la page Paramètres.
Exemple : si l’URL de vos paramètres est /my/organizers/1234/edit, votre organiser_id est 1234.

Exemple : récupérer les événements de l’organisateur 1234, en privilégiant l’anglais :

GET https://fienta.com/api/v1/public/events?organizer=1234&locale=en

Exemple : récupérer uniquement les événements en allemand pour l’organisateur 1234 :

GET https://fienta.com/api/v1/public/events?organizer=1234&locale_strict=de

Consultez tous les paramètres disponibles dans notre documentation de l’API.

Réponse

Exemple de réponse JSON de l’API :

{"events": [
   {
    "id": 5678,
    "title": "Festival indie",
    "starts_at": "2020-12-16 19:00:00",
    "ends_at": "2020-12-16 21:15:00",
    "duration_string": "lun. 16 décembre 2020, 19:00 - 21:15",
    "venue": "Millennium Park",
    "address": "201 E Randolph St, Chicago, IL 60602",
    "description": "Un week-end de festival primé qui se déroule en périphérie de ..",
    "url": "https:\/\/fienta.com\/indie-festival",
    "buy_tickets_url":"https:\/\/fienta.com\/indie-festival",
    "image_url": "https:\/\/fienta.com\/uploads\/5678.jpg",
    "organizer_name": "Smith Events Ltd.",
    "organizer_phone": "+81 555 666",
    "organizer_email": "[email protected]",
  },
]}

id
Identifiant unique de l’événement.

title
Titre de l’événement.

starts_at, ends_at
Date et heure de début et de fin de l’événement.

duration_string
Chaîne formatée indiquant les heures de début et de fin.

venue
Nom du lieu.

address
Adresse du lieu, sans le nom du pays.

description
Description de l’événement. Peut inclure du HTML.

url
URL complète de la page d’événement sur Fienta.

buy_tickets_url
URL complète de la page de vente de billets de l’événement. Si les billets sont vendus sur Fienta, la valeur est identique à celle du paramètre « url ». Si les billets sont vendus sur une plateforme externe, l’URL correspondante est renvoyée. Si l’événement n’a ni billetterie ni inscription, une valeur vide est renvoyée.

image_url
URL de l’image de l’événement.

organizer_name
Nom de l’organisateur.

organizer_phone
Numéro de téléphone de l’organisateur.

organizer_email
Adresse e-mail de l’organisateur.

Exemple en JavaScript

Exemple de récupération des événements depuis Fienta et d’affichage en HTML sur votre site avec JavaScript et jQuery :

<div id="events">
  <!-- La liste des événements sera insérée dans cette zone -->
</div>

<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>
jQuery(document).ready(function() {
  // Élément HTML qui contiendra la liste d’événements
  var container = jQuery('#events'); 
  // Charger les événements à venir depuis Fienta
  jQuery.getJSON('https://fienta.com/api/v1/public/events?organizer=1234', function(data) {
    // Parcourir les résultats
    data.events.forEach(function (event) {
      // Insérer les événements dans le DOM
      container.append(
        '<div>' +
        '<img src="' + event.image_url + '">' +
        '<h2>' + event.title + '</h2>' +
        '<p>' + event.duration_string + ' @ ' + 
        event.venue + ', ' + event.address + '</p>' +
        '<p><a href="' + event.url + '">Acheter des billets</a></p>' +
        '<p>' + event.description + '</p>' +
        '</div>'
      );
    });
  });
});
</script>

<!-- Facultatif : intégrer le processus d’achat de billets -->
<script src="https://fienta.com/embed.js"></script>