Integrācijas

Pasākumu parādīšana jūsu mājaslapā

Pasākumu parādīšana

Visus savus Fienta pasākumus varat parādīt tieši savā mājaslapā. Ar nelielu programmēšanu jūs varat noformēt un strukturēt sarakstu tā, lai tas atbilstu jūsu vietnes stilam un uzbūvei.

Publiskais API

Mūsu publiskais API ir veidots pēc REST, atgriež JSON-encoded atbildes un izmanto standarta HTTP atbilžu kodus.

Endpoint

Izmantojot šo galapunktu, varat iegūt viena organizatora publicēto, neprivāto gaidāmo pasākumu sarakstu:

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

<locale>
Divi mazie burti, kas norāda pasākuma valodu. Tiks atgriezti arī pasākumi, kas ievadīti citās valodās. Lai iegūtu tikai konkrētas valodas pasākumus, pieprasījumam pievienojiet parametru "locale_strict".

<organiser_id>
Organizatora ID Fienta sistēmā. To var atrast URL adresē, atverot iestatījumu lapu.
Piemērs: ja jūsu iestatījumu lapas URL ir /my/organizers/1234/edit, jūsu organiser_id ir 1245.

Piemērs: iegūt organizatora 1234 pasākumus, dodot priekšroku angļu valodai:

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

Piemērs: iegūt tikai organizatora 1234 pasākumus vācu valodā:

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

Visus pieejamos parametrus skatiet mūsu API dokumentācijā.

Atbilde

JSON API atbildes piemērs

{"events": [
   {
    "id": 5678,
    "title": "Indie festivāls",
    "starts_at": "2020-12-16 19:00:00",
    "ends_at": "2020-12-16 21:15:00",
    "duration_string": "Pirmdien, 2020. gada 16. decembrī plkst. 19:00 - 21:15",
    "venue": "Millennium Park",
    "address": "201 E Randolph St, Chicago, IL 60602",
    "description": "Apbalvots festivāla nedēļas nogales pasākums, kas notiek pilsētas nomalē..",
    "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
Pasākuma unikālais ID.

title
Pasākuma nosaukums.

starts_at, ends_at
Pasākuma sākuma un beigu datums un laiks.

duration_string
Formatēta sākuma un beigu laika virkne.

venue
Norises vietas nosaukums.

address
Norises vietas adrese bez valsts nosaukuma.

description
Pasākuma apraksts, kurā var būt iekļauts HTML.

url
Pilns Fienta pasākuma lapas URL.

buy_tickets_url
Pilns pasākuma biļešu tirdzniecības lapas URL. Ja biļetes tiek pārdotas Fienta, vērtība sakrīt ar parametru "url". Ja biļetes tiek pārdotas ārējā platformā, tiks atgriezts attiecīgais URL. Ja pasākumam nav biļešu tirdzniecības vai reģistrācijas, tiks atgriezta tukša vērtība.

image_url
Pasākuma attēla URL.

organizer_name
Organizatora nosaukums.

organizer_phone
Organizatora tālruņa numurs.

organizer_email
Organizatora e-pasta adrese.

JavaScript piemērs 

Piemērs, kā ar JavaScript un jQuery ielādēt pasākumus no Fienta un attēlot HTML savā mājaslapā:

<div id="events">
  <!-- Šajā div elementā tiks attēloti pasākumi -->
</div>

<script src="https://code.jquery.com/jquery-3.4.1.min.js"></script>
<script>
jQuery(document).ready(function() {
  // HTML elements, kurā tiks ievietots pasākumu saraksts
  var container = jQuery('#events'); 
  // Ielādē gaidāmos pasākumus no Fienta
  jQuery.getJSON('https://fienta.com/api/v1/public/events?organizer=1234', function(data) {
    // Iterē cauri rezultātiem
    data.events.forEach(function (event) {
      // Ievieto pasākumus 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 + '">Pirkt biļeti</a></p>' +
        '<p>' + event.description + '</p>' +
        '</div>'
      );
    });
  });
});
</script>

<!-- Pēc izvēles var iegult biļešu iegādes procesu -->
<script src="https://fienta.com/embed.js"></script>