Evenementen op je eigen website tonen (evenementenfeed)
Je kunt afzonderlijke evenementen vrijgeven voor een openbare JSON-feed zonder API-key en daarmee je eigen websiteagenda vullen vanuit Univents, inclusief vanafprijs en melding dat een evenement uitverkocht is.
Wil je je evenementen ook op je eigen website tonen, in je eigen design en niet als ingesloten Univents-pagina? Dan kun je daarvoor afzonderlijke evenementen vrijgeven. Univents levert ze vervolgens uit via een openbare, alleen-lezen feed die je website (of die van je bureau) kan ophalen en zelf kan weergeven.
Een evenement op de website tonen
De vrijgave doe je direct bij het evenement, niet centraal op één plek:
- Open het gewenste evenement.
- Klik in de kopregel van de detailweergave op de schakelaar Tonen op website.
- Univents slaat de wijziging direct op en bevestigt dit met een korte melding.
Is de schakelaar actief, dan verschijnt het evenement binnen enkele minuten in de feed. Zet je de schakelaar weer uit of verwijder je het evenement, dan verdwijnt het ook weer automatisch uit de feed. De schakelaar werkt alleen voor dat ene evenement. Er is geen bulkvrijgave voor alle evenementen ineens.
De schakelaar kan ook de AI-assistent voor je instellen, bijvoorbeeld met „Toon het zomerfeest op onze website”. Hij vraagt eerst om bevestiging, omdat de gegevens daarna openbaar op te halen zijn. Ook voordat de assistent de naam, korte tekst of beschrijving wijzigt van een evenement dat op je website staat, toont hij je een bevestiging met het evenement, de datum en de nieuwe tekst. Er wordt pas iets opgeslagen als je bevestigt.
Is een evenement vrijgegeven maar heeft het nog geen korte tekst, dan staat naast de schakelaar de melding Voor de lijstweergave ontbreekt nog een korte tekst. De melding blokkeert niets: het evenement verschijnt gewoon in de feed.
Wat er in de feed staat
De feed levert uitsluitend gegevens die bedoeld zijn voor een openbare agendaweergave: titel, beschrijving, korte tekst voor de lijstweergave, start- en eindtijd, of de datum al definitief is, locatie, omslagafbeelding, tags, een link naar de ticketverkoop (als het evenement een live geschakelde ticketpagina heeft; in het concept ontbreken ticketlink en prijs), en daarnaast de goedkoopste nog beschikbare ticketprijs en een uitverkocht-indicatie. Interne gegevens zoals budget, aantal gasten, notities, contactgegevens, status of financiële gegevens staan nooit in de feed, ongeacht of het evenement openbaar is geschakeld. Ook contingenten, categorienamen en verkoopcijfers blijven intern. Naar buiten gaan alleen de prijs en de informatie „uitverkocht ja/nee”.
Vanafprijs en uitverkocht
Verkoop je tickets via Univents, dan levert de feed twee extra gegevens waarmee je website een „vanaf 25 €” en een „Uitverkocht” kan opbouwen:
price_from: de goedkoopste ticketprijs die een bezoeker op dit moment nog kan kopen, als brutobedrag (dus wat in de ticketshop bij de categorie staat). Is je goedkoopste categorie uitverkocht, dan schuift automatisch de eerstvolgende duurdere categorie door. Zo belooft de website nooit een prijs die er in de shop niet meer is.price_from_currency: de valuta van je workspace als code, bijvoorbeeldEURofCHF.tickets_sold_out:truezodra geen enkele ticketcategorie meer te koop is. Zolang er nog een categorie tickets heeft, blijft de waardefalse, ook als afzonderlijke categorieën al vol zijn.
Is alles uitverkocht, dan is price_from leeg (null), want een vanafprijs naast „Uitverkocht” zou uitnodigen tot een aankoop die niet mogelijk is. Een evenement zonder ticketverkoop levert price_from: null en tickets_sold_out: false: het verkoopt niets, dus is het ook niet uitverkocht.
Annuleer je een ticket, dan komt de plek direct weer vrij. De categorie is dan weer te koop en telt weer mee in de vanafprijs. Omdat de feed kort wordt gecachet, kan een net uitverkocht evenement op je website nog enkele minuten als beschikbaar verschijnen.
Korte tekst of beschrijving?
Veel websites tonen hun evenementen twee keer: als korte kaart in een lijst en uitgebreid op een eigen detailpagina. Voor de lijst is de volledige beschrijving vaak te lang. Daarvoor is er de Korte tekst voor je website:
- Open het evenement en klik op Evenement bewerken.
- Direct onder de Beschrijving vind je het veld Korte tekst voor je website.
- Vul een of twee zinnen in (maximaal 280 tekens, zonder opmaak) en sla op.
De feed levert de korte tekst als apart veld short_description, zowel in de lijst als in de enkelvoudige weergave. De beschrijving blijft ongewijzigd en staat volledig in het veld description. Welke tekst je website waar toont, bepaalt de website zelf: meestal de korte tekst in de lijst en de beschrijving op de detailpagina.
Onderhoud je geen korte tekst, dan is short_description leeg (null). Univents kort de beschrijving nooit automatisch in en gebruikt haar ook niet als vervanging, want anders zou er ongevraagd een afgekapte zin op je website kunnen staan. Voor evenementen zonder korte tekst verandert er in de feed dus niets.
Bij het kopiëren van een evenement en bij het aanmaken van een reeks afspraken wordt de korte tekst meegenomen, net als de beschrijving. In de Excel-import heet de kolom Korte tekst.
Afbeelding en beschrijving: evenement, niet ticketpagina
Voor de websiteagenda tellen afbeelding en beschrijving van het evenement zelf, dus wat je in het evenement onder Weergave onderhoudt. Afbeelding en beschrijving van een boekings- of ticketpagina horen bij die pagina en worden niet automatisch overgenomen in de websiteagenda. Dat is bewust zo: veel bedrijven tonen in de ticketshop opzettelijk een ander beeld dan in de agenda op hun eigen website.
Wil je dat beide hetzelfde zijn, dan moet je dat eenmalig aangeven:
- Open de boekings- of ticketpagina en daar het onderdeel Details.
- Onder afbeelding en beschrijving vind je de toelichting met de knop Ook overnemen voor de websiteagenda.
- Bevestig de controlevraag. Afbeelding en beschrijving van de pagina worden dan overgezet naar het gekoppelde evenement; de gegevens die daar eerder stonden, worden overschreven.
De knop verschijnt alleen als de pagina aan een evenement is gekoppeld (bij ticketpagina’s is dat altijd zo). Overgenomen wordt de laatst opgeslagen versie van de pagina, en velden die op de pagina leeg zijn, blijven bij het evenement ongewijzigd. Een lege pagina wist dus nooit een afbeelding. Het kan enkele minuten duren voordat de wijziging in de websiteagenda aankomt, omdat de feed kort wordt gecachet.
Hoe groot de afbeelding verschijnt, bepaalt jullie website. Univents levert de afbeelding in originele grootte.
De feed ophalen
De feed is openbaar en zonder aanmelding of API-key op te halen. Een website of extern hulpmiddel kan hem direct met fetch laden:
GET https://univents.app/api/public/dein-workspace/events
GET https://univents.app/api/public/dein-workspace/events/{eventId}
dein-workspace is de slug van je workspace, die je ook in de adresbalk van je computer achter /home/ vindt. Met de parameters from en to beperk je de periode, met limit het aantal resultaten (standaard 50, maximaal 100). limit is verdeeld over drie stappen (25, 50 of 100), zodat de cache met weinig varianten toe kan: een opgevraagde waarde wordt altijd naar boven afgerond op de eerstvolgende stap. Zo levert ?limit=10 evenveel items (25) als ?limit=25, en alles boven 100 wordt afgekapt op 100. Zonder opgave levert de feed alle vrijgegeven evenementen vanaf vandaag.
Een voorbeeldantwoord ziet er zo uit:
{
"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"
}
]
}
Voor ontwikkelaars en bureaus
De feed is bewust zo gebouwd dat hij direct in een bestaande website te integreren is, zonder dat je toegangsgegevens hoeft te beheren:
- Geen auth, geen API-key: de route is openbaar bereikbaar, maar levert uitsluitend evenementen van de betreffende workspace waarbij de schakelaar aan staat.
- CORS staat open, dus een aanroep met
fetchwerkt direct vanuit de browser van elke website. - Gecachet: antwoorden zijn kort cachebaar (enkele minuten), zodat frequente aanroepen snel blijven. Een net vrijgegeven evenement verschijnt daardoor niet meteen, maar binnen enkele minuten.
- Met rate limit: bij zeer veel aanroepen in korte tijd vanaf dezelfde bron antwoordt de route met een fout in plaats van met lege data. Voor normaal websitegebruik speelt dit geen rol.
- Een onbekende workspace-slug levert een fout op, geen lege lijst. Zo merk je meteen dat de slug niet klopt.
Veelgestelde vragen
Zie ik in de feed ook locaties die alleen bezet zijn maar niet openbaar zijn geschakeld? Nee. De feed toont uitsluitend evenementen waarbij je de schakelaar Tonen op website hebt geactiveerd, nooit de algemene locatiebezetting.
Bevat de feed prijzen? Ja, één: de goedkoopste nog beschikbare ticketprijs (price_from, bruto) inclusief valuta. De volledige prijslijst staat nog steeds alleen op de boekingspagina waar ticket_url naar verwijst.
Waarom toont mijn website een hogere prijs dan gisteren? Omdat de goedkopere categorie inmiddels uitverkocht is. De feed noemt altijd de goedkoopste prijs die je nog kunt kopen, niet de goedkoopste die er ooit was.
Waarom staat er bij mijn evenement zonder tickets niet „uitverkocht”? Omdat het geen tickets verkoopt. tickets_sold_out is alleen true als er ticketverkoop is en daar niets meer te krijgen is.
Moet ik een korte tekst invullen? Nee. De korte tekst is optioneel. Zonder korte tekst levert de feed short_description: null, en je website toont wat hij tot nu toe toonde.
Wordt de korte tekst ook op de boekings- of ticketpagina getoond? Nee. De korte tekst is alleen bedoeld voor de websitefeed. Hij verschijnt niet in de offerte, het Function Sheet, op de boekingspagina of in het klantenportaal.
Moet ik elk evenement apart vrijgeven? Ja, op dit moment is er geen bulkvrijgave. De schakelaar staat bewust bij elk evenement afzonderlijk, zodat je volledige controle hebt over wat openbaar zichtbaar is.
Is de functie gebonden aan een bepaald abonnement? Ja, aan het onderdeel Evenementen: dat is er vanaf het abonnement Core, en daarmee ook de schakelaar Tonen op website. Verder heb je niets nodig. De feed toont uitsluitend wat je zelf vrijgeeft.
Kost het ophalen van de feed me iets? Nee, de feed is puur leestoegang tot gegevens die je al hebt vrijgegeven. Er zijn geen aparte kosten aan verbonden.