Fienta renginių rodymas jūsų svetainėje

Renginių rodymas

Visus savo Fienta renginius galite rodyti tiesiai savo svetainėje. Su nedideliu programavimu sąrašą galite stilizuoti ir formatuoti pagal svetainės dizainą ir struktūrą.

Viešasis API

Mūsų viešasis API sukurtas pagal REST principą, grąžina JSON formatu koduotus atsakymus ir naudoja standartinius HTTP atsakymo kodus.

Pabaigos adresas (endpoint)

Vieno organizatoriaus paskelbtų, neprivačių būsimų renginių sąrašą galite gauti naudodami šį pabaigos adresą:

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

<locale>
Dvi mažosios raidės – pageidaujama renginio kalba. Renginiai, įvesti kitomis kalbomis, vis tiek bus grąžinami. Jei norite tik tam tikros kalbos renginių, užklausoje pridėkite parametrą „locale_strict“.

<organiser_id>
Organizatoriaus ID Fienta sistemoje. Jį rasite URL, atidarę Nustatymų puslapį.
Pavyzdys: jei jūsų Nustatymų puslapio URL yra /my/organizers/1234/edit, jūsų organiser_id yra 1234.

Pavyzdys: gauti organizatoriaus 1234 renginius, pageidaujant anglų kalbą:

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

Pavyzdys: gauti tik vokiečių kalbos renginius iš organizatoriaus 1234:

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

Visus galimus parametrus žr. mūsų API dokumentacijoje.

Atsakas (response)

Pavyzdinis JSON API atsakas:

{"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
Unikalus renginio ID.

title
Renginio pavadinimas.

starts_at, ends_at
Renginio pradžios ir pabaigos data bei laikas.

duration_string
Suformatuota eilutė su pradžios ir pabaigos laikais.

venue
Renginio vietos pavadinimas.

address
Renginio vietos adresas be šalies pavadinimo.

description
Renginio aprašas. Gali būti su HTML.

url
Pilnas renginio puslapio Fienta URL.

buy_tickets_url
Pilnas bilietų pardavimo puslapio URL. Jei bilietai parduodami Fienta, reikšmė tokia pati kaip parametro „url“. Jei bilietai parduodami išorėje, grąžinamas atitinkamas URL. Jei renginys neturi bilietų ar registracijos, grąžinama tuščia reikšmė.

image_url
Renginio paveikslėlio URL.

organizer_name
Organizatoriaus pavadinimas.

organizer_phone
Organizatoriaus telefono numeris.

organizer_email
Organizatoriaus el. pašto adresas.

JavaScript pavyzdys

Pavyzdys, kaip iš Fienta gauti renginius ir savo svetainėje su JavaScript ir jQuery atvaizduoti HTML:

<div id="events">
  <!-- Renginiai bus įterpti į šį div -->
</div>

<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>
jQuery(document).ready(function() {
  // HTML elementas, kuriame bus sąrašas
  var container = jQuery('#events'); 
  // Gauti būsimus renginius iš Fienta
  jQuery.getJSON('https://fienta.com/api/v1/public/events?organizer=1234', function(data) {
    // Eiti per rezultatus
    data.events.forEach(function (event) {
      // Įrašyti renginius į 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 + '">Pirkti bilietą</a></p>' +
        '<p>' + event.description + '</p>' +
        '</div>'
      );
    });
  });
});
</script>

<!-- Pasirinktinai: įterpti bilietų pirkimo procesą -->
<script src="https://fienta.com/embed.js"></script>