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 zum Stil und zur Struktur Ihrer Website passt.

Öffentliche API

Unsere öffentliche API ist REST-basiert, gibt JSON-kodierte 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 https://fienta.com/api/v1/public/events?organizer=<organiser_id>

<locale>
Zwei Kleinbuchstaben, die die Sprache der Veranstaltung angeben. Veranstaltungen, die in anderen Sprachen erstellt wurden, werden weiterhin abgerufen. Wenn Sie nur Veranstaltungen in einer bestimmten Sprache erhalten möchten, fügen Sie den Parameter "locale_strict" 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, lautet Ihre organiser_id 1234.

Beispiel: Veranstaltungen von Veranstalter 1234 abrufen, bevorzugt auf Deutsch:

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

Beispiel: Nur deutsche Veranstaltungen von Veranstalter 1234 abrufen:

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

Alle verfügbaren Parameter finden Sie in unserer API-Dokumentation.

Antwort

Beispiel für eine 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ändernamen.

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('https://fienta.com/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="https://fienta.com/embed.js"></script>