Integracje

Wyświetlanie wydarzeń z Fienta na własnej stronie

Wyświetlanie wydarzeń

Możesz wyświetlać wszystkie wydarzenia z Fienta bezpośrednio na własnej stronie. Przy odrobinie programowania możesz nadać liście wygląd i układ zgodny ze stylem Twojej witryny.

Public API

Nasze publiczne API jest oparte o REST, zwraca JSON-encoded odpowiedzi i używa standardowych kodów odpowiedzi HTTP.

Endpoint

Listę opublikowanych, nieprywatnych nadchodzących wydarzeń jednego organizatora możesz pobrać przez endpoint:

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

<locale>
Dwie małe litery oznaczające język wydarzenia. Wydarzenia w innych językach nadal zostaną zwrócone. Aby pobrać tylko wydarzenia w konkretnym języku, dodaj do zapytania parametr „locale_strict”.

<organiser_id>
Identyfikator organizatora w Fienta. Znajdziesz go w adresie URL na stronie Ustawień.
Przykład: jeśli adres URL strony Ustawień to /my/organizers/1234/edit, Twoje organiser_id to 1245.

Przykład: pobierz wydarzenia organizatora 1234, preferując język angielski:

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

Przykład: pobierz tylko niemieckie wydarzenia organizatora 1234:

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

Wszystkie dostępne parametry znajdziesz w dokumentacji API.

Odpowiedź

Przykładowa odpowiedź JSON API

{"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
Unikalny identyfikator wydarzenia.

title
Tytuł wydarzenia.

starts_at, ends_at
Data i godzina rozpoczęcia oraz zakończenia wydarzenia.

duration_string
Sformatowany zapis czasu rozpoczęcia i zakończenia.

venue
Nazwa miejsca.

address
Adres miejsca, bez nazwy kraju.

description
Opis wydarzenia, może zawierać HTML.

url
Pełny URL strony wydarzenia w Fienta.

buy_tickets_url
Pełny URL strony sprzedaży biletów. Jeśli bilety są sprzedawane w Fienta, wartość jest taka sama jak w polu „url”. Jeśli bilety są sprzedawane na zewnętrznej platformie, zwracany jest odpowiedni adres. Jeśli wydarzenie nie ma sprzedaży biletów ani rejestracji, zwracana jest pusta wartość.

image_url
URL obrazu wydarzenia.

organizer_name
Nazwa organizatora.

organizer_phone
Numer telefonu organizatora.

organizer_email
Adres e-mail organizatora.

Przykład JavaScript 

Przykład pobierania wydarzeń z Fienta i renderowania HTML na własnej stronie przy użyciu JavaScript i jQuery:

<div id="events">
  <!-- Wydarzenia zostaną wyrenderowane w tym divie -->
</div>

<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>
jQuery(document).ready(function() {
  // Element HTML, który będzie zawierał listę wydarzeń
  var container = jQuery('#events'); 
  // Pobierz nadchodzące wydarzenia z Fienta
  jQuery.getJSON('https://fienta.com/api/v1/public/events?organizer=1234', function(data) {
    // Przejdź przez wyniki
    data.events.forEach(function (event) {
      // Wstaw wydarzenia do 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 + '">Kup bilet</a></p>' +
        '<p>' + event.description + '</p>' +
        '</div>'
      );
    });
  });
});
</script>

<!-- Opcjonalnie: osadź proces zakupu biletów -->
<script src="https://fienta.com/embed.js"></script>