Integration

Veranstaltungen von Fienta auf Ihrer eigenen Website anzeigen

Veranstaltungen anzeigen

Sie können alle Ihre Veranstaltungen von Fienta direkt auf Ihrer eigenen Website anzeigen. Mit etwas Programmierung können Sie die Liste so gestalten und formatieren, dass sie zu den Stilen und der Struktur Ihrer Website passt.

Öffentliche API

Unsere öffentliche API ist organisiert um REST, gibt JSON-codierte Antworten zurück und verwendet Standard-HTTP-Antwortcodes.

Endpunkt

Sie können eine Liste veröffentlichter, nicht privater bevorstehender Veranstaltungen eines einzelnen Veranstalters abrufen, indem Sie den Endpunkt verwenden:

GET /api/v1/public/events?organizer=<organiser_id>

<locale>
Zwei Kleinbuchstaben, die die Sprache der Veranstaltung angeben. Veranstaltungen, die in anderen Sprachen eingegeben wurden, werden weiterhin abgerufen. Um nur Veranstaltungen mit einer bestimmten Sprache zu erhalten, fügen Sie den Parameter "locale_strct" zur Abfrage hinzu.

<organiser_id>
Die ID des Veranstalters auf Fienta. Sie finden sie in der URL, wenn Sie die Einstellungsseite besuchen.
Beispiel: Wenn Ihre Einstellungsseiten-URL /my/organizers/1234/edit ist, ist Ihre organiser_id 1245.

Beispiel: Veranstaltungen von Veranstalter 1234 abrufen, bevorzugt deutsche Sprache:

GET /api/v1/public/events?organizer=1234&locale=de

Beispiel: Nur deutsche Veranstaltungen von Veranstalter 1234 abrufen:

GET /api/v1/public/events?organizer=1234&locale_strict=de

Bitte sehen Sie alle verfügbaren Parameter in unserer API-Dokumentation.

Antwort

Beispiel JSON-API-Antwort

{"events": [
   {
    "id": 5678,
    "title": "Indie festival",
    "starts_at": "2020-12-16 19:00:00",
    "ends_at": "2020-12-16 21:15:00",
    "duration_string": "Mon 16. December 2020 at 19:00 - 21:15",
    "venue": "Millennium Park",
    "address": "201 E Randolph St, Chicago, IL 60602",
    "description": "An award winning festival weekender which takes place on the outskirts of ..",
    "url": "https:\/\/fienta.com\/indie-festival",
    "buy_tickets_url":"https:\/\/fienta.com\/indie-festival",
    "image_url": "https:\/\/fienta.com\/uploads\/5678.jpg",
    "organizer_name": "Smdith Events Ltd.",
    "organizer_phone": "+81 555 666",
    "organizer_email": "[email protected]",
  },
]}

id
Eindeutige ID der Veranstaltung.

title
Titel der Veranstaltung.

starts_at, ends_at
Start- und Enddatum/-zeit der Veranstaltung.

duration_string
Formatierte Zeichenkette von Start- und Endzeiten.

venue
Name des Veranstaltungsorts.

address
Adresse des Veranstaltungsorts, ohne Ländername.

description
Veranstaltungsbeschreibung, kann HTML enthalten.

url
Vollständige URL der Veranstaltungsseite auf Fienta.

buy_tickets_url
Vollständige URL der Ticketverkaufsseite der Veranstaltung. Wenn die Tickets auf Fienta verkauft werden, entspricht der Wert dem Parameter "url". Wenn die Tickets auf einer externen Plattform verkauft werden, wird die entsprechende URL zurückgegeben. Wenn die Veranstaltung kein Ticketing oder keine Registrierung hat, wird ein leerer Wert zurückgegeben.

image_url
URL des Veranstaltungsbildes.

organizer_name
Name des Veranstalters.

organizer_phone
Telefonnummer des Veranstalters.

organizer_email
E-Mail-Adresse des Veranstalters.

JavaScript-Beispiel 

Beispiel zum Abrufen von Veranstaltungen von Fienta und Rendern von HTML auf Ihrer eigenen Website mit JavaScript und jQuery:

<div id="events">
  <!-- Events will be rendered inside this div -->
</div>

<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>
jQuery(document).ready(function() {
  // HTML element which will include event list
  var container = jQuery('#events'); 
  // Pull upcoming events from Fienta
  jQuery.getJSON('/api/v1/public/events?organizer=1234', function(data) {
    // Cycle through the results
    data.events.forEach(function (event) {
      // Write events into 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 + '">Ticket kaufen</a></p>' +
        '<p>' + event.description + '</p>' +
        '</div>'
      );
    });
  });
});
</script>

<!-- Optionally, embed ticket purchasing process -->
<script src="/embed.js"></script>