Mostrar eventos de Fienta en tu web

Mostrar eventos

Puedes mostrar todos tus eventos de Fienta directamente en tu web. Con un poco de programación, puedes dar estilo y formato a la lista para que encaje con el diseño y la estructura de tu sitio.

API pública

Nuestra API pública está organizada en torno a REST, devuelve respuestas codificadas en JSON y usa códigos de respuesta HTTP estándar.

Endpoint

Puedes obtener una lista de próximos eventos publicados y no privados de un único organizador usando este endpoint:

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

<locale>
Dos letras minúsculas que indican el idioma preferido del evento. Los eventos introducidos en otros idiomas seguirán devolviéndose. Para obtener solo los eventos de un idioma concreto, añade el parámetro "locale_strict" a la consulta.

<organizer_id>
El ID del organizador en Fienta. Puedes encontrarlo en la URL al visitar la página de Ajustes.
Ejemplo: si la URL de tu página de Ajustes es /my/organizers/1234/edit, tu organizer_id es 1234.

Ejemplo: obtener eventos del organizador 1234, priorizando el idioma inglés:

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

Ejemplo: obtener solo eventos en alemán del organizador 1234:

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

Consulta todos los parámetros disponibles en nuestra documentación de la API.

Respuesta

Ejemplo de respuesta JSON de la 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 de diciembre de 2020 a las 19:00 - 21:15",
    "venue": "Millennium Park",
    "address": "201 E Randolph St, Chicago, IL 60602",
    "description": "Un festival premiado que se celebra a las afueras 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": "Smidth Events Ltd.",
    "organizer_phone": "+81 555 666",
    "organizer_email": "[email protected]",
  },
]}

id
ID único del evento.

title
Título del evento.

starts_at, ends_at
La fecha y hora de inicio y fin del evento.

duration_string
Una cadena formateada que muestra las horas de inicio y fin.

venue
Nombre del recinto.

address
Dirección del recinto, sin el nombre del país.

description
La descripción del evento. Puede incluir HTML.

url
URL completa de la página del evento en Fienta.

buy_tickets_url
La URL completa de la página de venta de entradas del evento. Si las entradas se venden en Fienta, el valor es el mismo que el parámetro "url". Si las entradas se venden en una plataforma externa, se devuelve la URL correspondiente. Si el evento no tiene venta de entradas ni registro, se devuelve un valor vacío.

image_url
URL de la imagen del evento.

organizer_name
Nombre del organizador.

organizer_phone
Número de teléfono del organizador.

organizer_email
Dirección de correo electrónico del organizador.

Ejemplo en JavaScript

Ejemplo para obtener eventos de Fienta y renderizar HTML en tu propia web usando JavaScript y jQuery:

<div id="events">
  <!-- Los eventos se renderizarán dentro de este div -->
</div>

<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>
jQuery(document).ready(function() {
  // Elemento HTML que incluirá la lista de eventos
  var container = jQuery('#events'); 
  // Obtener los próximos eventos de Fienta
  jQuery.getJSON('https://fienta.com/api/v1/public/events?organizer=1234', function(data) {
    // Recorrer los resultados
    data.events.forEach(function (event) {
      // Escribir los eventos en el 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 + '">Comprar entrada</a></p>' +
        '<p>' + event.description + '</p>' +
        '</div>'
      );
    });
  });
});
</script>

<!-- Opcionalmente, incrusta el proceso de compra de entradas -->
<script src="https://fienta.com/embed.js"></script>