Wyświetlanie wydarzeń na własnej stronie internetowej (feed wydarzeń)

Możesz udostępnić wybrane wydarzenia w publicznym feedzie JSON bez klucza i zasilać nim własny kalendarz na stronie internetowej z Univents — wraz z ceną „od” i informacją o wyprzedaniu.

Chcesz pokazywać swoje wydarzenia także na własnej stronie internetowej — w jej własnym designie, a nie jako osadzoną stronę Univents? W takim przypadku możesz udostępnić wybrane wydarzenia. Univents udostępnia je wtedy w publicznym feedzie tylko do odczytu, który Twoja strona (lub strona Twojej agencji) może pobrać i samodzielnie wyświetlić.

Pokazanie wydarzenia na stronie internetowej

Udostępnianie odbywa się bezpośrednio przy wydarzeniu, a nie centralnie w jednym miejscu:

  1. Otwórz wybrane wydarzenie.
  2. Kliknij w nagłówku widoku szczegółowego przełącznik Pokaż na stronie.
  3. Univents od razu zapisuje zmianę i potwierdza ją krótkim komunikatem.

Gdy przełącznik jest włączony, wydarzenie pojawia się w feedzie w ciągu kilku minut. Jeśli wyłączysz przełącznik lub usuniesz wydarzenie, zniknie ono z feedu równie automatycznie. Przełącznik działa tylko dla tego jednego wydarzenia — nie ma zbiorczego udostępniania wszystkich wydarzeń naraz.

Przełącznik może za Ciebie ustawić także asystent AI, na przykład po poleceniu „Pokaż Letni Festyn na naszej stronie”. Wcześniej dopyta, ponieważ po tej zmianie dane będą publicznie dostępne. Również zanim asystent zmieni nazwę, krótki tekst lub opis wydarzenia widocznego na Twojej stronie, pokaże Ci potwierdzenie z wydarzeniem, terminem i nowym tekstem. Nic nie zostanie zapisane, dopóki nie potwierdzisz.

Jeśli wydarzenie jest udostępnione, ale nie ma jeszcze krótkiego tekstu, obok przełącznika pojawi się komunikat Brakuje jeszcze krótkiego opisu do widoku listy. Komunikat niczego nie blokuje — wydarzenie mimo to pojawi się w feedzie.

Co znajduje się w feedzie

Feed zawiera wyłącznie dane przeznaczone do publicznego wyświetlania w kalendarzu: tytuł, opis, krótki tekst do widoku listy, godzinę rozpoczęcia i zakończenia, informację, czy termin jest już ostateczny, miejsce wydarzenia, zdjęcie główne, tagi, link do sprzedaży biletów (jeśli wydarzenie ma aktywną stronę biletową – w wersji roboczej brakuje linku do biletów i ceny), a także najtańszą wciąż dostępną cenę biletu oraz informację o wyprzedaniu. Dane wewnętrzne, takie jak budżet, liczba gości, notatki, dane kontaktowe, status czy dane finansowe, nigdy nie trafiają do feedu — niezależnie od tego, czy wydarzenie jest publiczne. Pule biletów, nazwy kategorii i dane o sprzedaży również zostają wewnątrz — na zewnątrz trafia tylko cena i informacja „wyprzedane tak/nie”.

Cena „od” i Wyprzedane

Jeśli sprzedajesz bilety przez Univents, feed zawiera dwie dodatkowe informacje, z których Twoja strona może zbudować napis „Od 25 €” oraz oznaczenie „Wyprzedane”:

  • price_from — najtańsza cena biletu, który odwiedzający może jeszcze kupić, jako kwota brutto (czyli to, co w sklepie z biletami widnieje przy kategorii). Jeśli najtańsza kategoria jest wyprzedana, automatycznie wskakuje kolejna, droższa. Dzięki temu strona nigdy nie obiecuje ceny, której nie ma już w sklepie.
  • price_from_currency — waluta Twojego Workspace jako skrót, np. EUR lub CHF.
  • tickets_sold_out — true, gdy żadna kategoria biletów nie jest już dostępna do kupienia. Dopóki jakakolwiek kategoria ma jeszcze bilety, wartość pozostaje false, nawet jeśli pojedyncze kategorie są już pełne.

Jeśli wszystko jest wyprzedane, price_from jest puste (null) — cena „od” obok informacji „Wyprzedane” zachęcałaby do zakupu, który nie jest możliwy. Wydarzenie bez sprzedaży biletów zwraca price_from: null i tickets_sold_out: false: nic nie sprzedaje, więc nie może być też wyprzedane.

Jeśli anulujesz bilet, miejsce od razu znów się zwalnia — kategoria jest wtedy ponownie dostępna do kupienia i znów uwzględniana w cenie „od”. Ponieważ feed jest krótko buforowany, wydarzenie, które właśnie się wyprzedało, może na Twojej stronie jeszcze przez kilka minut wyglądać na dostępne.

Krótki tekst czy opis?

Wiele stron pokazuje wydarzenia dwukrotnie: jako krótką kartę na liście i szczegółowo na osobnej stronie wydarzenia. Pełny opis jest na listę często zbyt długi. Do tego służy Krótki opis na stronę internetową:

  1. Otwórz wydarzenie i kliknij Edytuj wydarzenie.
  2. Bezpośrednio pod polem Opis znajdziesz pole Krótki opis na stronę internetową.
  3. Wpisz jedno lub dwa zdania (maksymalnie 280 znaków, bez formatowania) i zapisz.

Feed zwraca krótki tekst jako osobne pole short_description — zarówno na liście, jak i w widoku pojedynczego wydarzenia. Opis pozostaje bez zmian i w całości znajduje się w polu description. To, który tekst Twoja strona pokaże i gdzie, zależy od strony: zazwyczaj krótki tekst na liście, a opis na stronie szczegółowej.

Jeśli nie uzupełnisz krótkiego tekstu, short_description będzie puste (null). Univents nigdy nie skraca opisu automatycznie i nie podstawia go w zastępstwie — w przeciwnym razie urwane zdanie pojawiłoby się na Twojej stronie bez Twojej zgody. Dla wydarzeń bez krótkiego tekstu w feedzie nic się więc nie zmienia.

Podczas kopiowania wydarzenia i tworzenia serii terminów krótki tekst jest przenoszony razem z opisem. W imporcie z Excela kolumna nazywa się Krótki tekst.

Obraz i opis: wydarzenie, a nie strona biletowa

W kalendarzu na stronie liczą się obraz i opis samego wydarzenia — czyli to, co uzupełniasz w wydarzeniu w sekcji Wygląd. Obraz i opis strony rezerwacji lub strony biletowej należą do tej strony i nie trafiają automatycznie do kalendarza na stronie internetowej. Jedno i drugie jest zamierzone: wiele firm celowo pokazuje w sklepie z biletami inny motyw niż w kalendarzu na własnej stronie.

Jeśli chcesz, aby oba były takie same, musisz to raz zlecić:

  1. Otwórz stronę rezerwacji lub stronę biletową i przejdź do sekcji Szczegóły.
  2. Pod obrazem i opisem znajdziesz informację oraz przycisk Zastosuj też w kalendarzu na stronie.
  3. Potwierdź pytanie. Obraz i opis strony zostaną wtedy przeniesione do powiązanego wydarzenia; dotychczasowe dane w wydarzeniu zostaną nadpisane.

Przycisk pojawia się tylko wtedy, gdy strona jest powiązana z wydarzeniem (w przypadku stron biletowych zawsze tak jest). Przenoszony jest ostatnio zapisany stan strony, a pola, które na stronie są puste, pozostają w wydarzeniu bez zmian — pusta strona nigdy więc nie usunie obrazu. Zanim zmiana dotrze do kalendarza na stronie, może upłynąć kilka minut, ponieważ feed jest krótko buforowany.

To, jak duży będzie wyświetlany obraz, określa Wasza strona — Univents dostarcza obraz w oryginalnym rozmiarze.

Pobieranie feedu

Feed jest publiczny i dostępny bez logowania oraz bez klucza API — strona internetowa lub zewnętrzne narzędzie może go pobrać bezpośrednio za pomocą fetch:

GET https://univents.app/api/public/dein-workspace/events
GET https://univents.app/api/public/dein-workspace/events/{eventId}

dein-workspace to slug Twojego Workspace, który znajdziesz też w pasku adresu przeglądarki po /home/. Parametrami from i to zawężasz zakres czasu, a parametrem limit liczbę wyników (domyślnie 50, maksymalnie 100). Wartość limit jest zaokrąglana do trzech poziomów — 25, 50 lub 100 — aby pamięć podręczna obsługiwała jak najmniej wariantów odpowiedzi: żądana wartość jest zawsze zaokrąglana w górę do najbliższego poziomu, np. ?limit=10 zwraca tak samo 25 wpisów jak ?limit=25, a wszystko powyżej 100 jest ograniczane do 100. Bez podania parametrów feed zwraca wszystkie udostępnione wydarzenia od dziś.

Przykładowa odpowiedź wygląda tak:

{
  "workspace": "dein-workspace",
  "count": 2,
  "events": [
    {
      "id": "…",
      "title": "Sommerkonzert",
      "description": "…",
      "short_description": "Open Air im Hof, Eintritt frei",
      "start": "2026-08-20T18:00:00Z",
      "end": "2026-08-20T23:00:00Z",
      "date_is_confirmed": true,
      "venue": "Großer Saal",
      "image_url": "https://…",
      "tags": ["Konzert"],
      "ticket_url": "https://univents.app/book/dein-workspace/deine-seite",
      "price_from": 25,
      "price_from_currency": "EUR",
      "tickets_sold_out": false,
      "updated_at": "2026-08-05T09:00:00Z"
    }
  ]
}

Dla programistów i agencji

Feed został celowo zaprojektowany tak, aby można go było wprost zintegrować z istniejącą stroną bez zarządzania danymi dostępowymi:

  • Brak uwierzytelniania i klucza API — adres jest publicznie dostępny, ale zwraca wyłącznie wydarzenia danego Workspace z włączonym przełącznikiem.
  • CORS jest otwarty, więc pobranie za pomocą fetch działa bezpośrednio w przeglądarce na dowolnej stronie.
  • Buforowanie — odpowiedzi są krótko buforowane (kilka minut), aby częste pobrania pozostawały szybkie. Świeżo udostępnione wydarzenie nie pojawia się więc natychmiast, lecz w ciągu kilku minut.
  • Limit zapytań — przy bardzo dużej liczbie pobrań z tego samego źródła w krótkim czasie adres odpowiada błędem zamiast pustymi danymi; przy normalnym użyciu na stronie nie ma to znaczenia.
  • Nieznany slug Workspace zwraca błąd, a nie pustą listę — dzięki temu od razu zauważysz, że slug jest błędny.

Najczęstsze pytania

Czy w feedzie widzę też lokalizacje, które są tylko zajęte, ale nie udostępnione publicznie? Nie. Feed pokazuje wyłącznie wydarzenia, przy których aktywowano przełącznik Pokaż na stronie — nigdy ogólnego obłożenia Twoich lokalizacji.

Czy feed zawiera ceny? Tak, jedną: najtańszą wciąż dostępną cenę biletu (price_from, brutto) wraz z walutą. Pełny cennik nadal znajduje się tylko na stronie rezerwacji, na którą wskazuje ticket_url.

Dlaczego moja strona pokazuje wyższą cenę niż wczoraj? Ponieważ tańsza kategoria jest już wyprzedana. Feed zawsze podaje najtańszą cenę, po której nadal można kupić bilet — a nie najtańszą, jaka kiedykolwiek istniała.

Dlaczego przy moim wydarzeniu bez biletów nie widnieje „Wyprzedane”? Ponieważ nie sprzedaje ono biletów. tickets_sold_out ma wartość true tylko wtedy, gdy istnieje sprzedaż biletów i nic już w niej nie zostało.

Czy muszę uzupełniać krótki tekst? Nie. Krótki tekst jest dobrowolny. Bez niego feed zwraca short_description: null, a Twoja strona pokazuje to, co pokazywała dotychczas.

Czy krótki tekst jest wyświetlany także na stronie rezerwacji lub stronie biletowej? Nie. Krótki tekst jest przeznaczony wyłącznie dla feedu na stronę internetową. Nie pojawia się ani w ofercie, ani w Function Sheet, na stronie rezerwacji ani w portalu klienta.

Czy muszę udostępniać każde wydarzenie osobno? Tak, obecnie nie ma udostępniania zbiorczego. Przełącznik celowo znajduje się osobno przy każdym wydarzeniu, abyś miał pełną kontrolę nad tym, co jest publicznie widoczne.

Czy ta funkcja jest powiązana z określonym planem? Tak, z obszarem Wydarzenia: jest on dostępny od planu Core, a wraz z nim przełącznik Pokaż na stronie. Poza tym nie potrzebujesz niczego więcej. Feed pokazuje wyłącznie to, co sam udostępnisz.

Czy pobieranie feedu coś mnie kosztuje? Nie, feed to wyłącznie odczyt danych, które już udostępniłeś — nie wiążą się z tym żadne dodatkowe koszty.

Newsletter Univents

Nowości produktowe i praktyczne wskazówki dla firm eventowych i cateringowych. Mniej więcej raz w miesiącu, nie częściej.

Newsletter wysyłamy w języku angielskim.

Tematy