Veranstaltungen auf der eigenen Website zeigen (Event-Feed)

Willst du deine Veranstaltungen zusätzlich auf deiner eigenen Website zeigen — im eigenen Design, nicht als eingebettete Univents-Seite —, kannst du dafür einzelne Events freigeben. Univents liefert sie dann über einen öffentlichen, schreibgeschützten Feed aus, den deine Website (oder die deiner Agentur) abrufen und selbst darstellen kann.

Eine Veranstaltung auf der Website zeigen

Die Freigabe passiert direkt am Event, nicht zentral an einer Stelle:

1. Öffne die gewünschte Veranstaltung.
2. Klicke in der Kopfzeile der Detailansicht auf den Schalter Auf Website zeigen.
3. Univents speichert die Änderung sofort und bestätigt mit einer kurzen Meldung.

Ist der Schalter aktiv, taucht die Veranstaltung innerhalb weniger Minuten im Feed auf. Schaltest du sie wieder aus oder löschst du die Veranstaltung, verschwindet sie ebenso automatisch wieder daraus. Der Schalter wirkt nur auf diese eine Veranstaltung — es gibt keine Sammel-Freigabe für alle Events auf einmal.

Was im Feed steht

Der Feed liefert ausschließlich Angaben, die für eine öffentliche Kalenderdarstellung gedacht sind: Titel, Beschreibung, Start- und Endzeit, ob das Datum bereits final ist, Veranstaltungsort, Titelbild, Tags sowie einen Link zum Ticketverkauf (falls die Veranstaltung eine Ticket-Buchungsseite hat). Interne Angaben wie Budget, Gästezahl, Notizen, Kontaktdaten, Status oder Finanzdaten stehen nie im Feed, unabhängig davon, ob die Veranstaltung öffentlich geschaltet ist.

Den Feed abrufen

Der Feed ist öffentlich und ohne Anmeldung oder API-Key abrufbar — eine Website oder ein externes Tool kann ihn direkt per fetch laden:

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

dein-workspace ist der Slug deines Workspaces, den du auch in der Adresszeile deines Rechners hinter /home/ findest. Über die Parameter from und to grenzt du den Zeitraum ein, über limit die Anzahl der Ergebnisse (Standard 50, maximal 100). limit ist auf drei Stufen gerastert — 25, 50 oder 100 —, damit der Cache mit wenigen Antworten auskommt: Ein angefragter Wert wird immer auf die nächsthöhere Stufe aufgerundet, z. B. liefert ?limit=10 genauso 25 Einträge wie ?limit=25, und alles über 100 wird auf 100 gedeckelt. Ohne Angabe liefert der Feed alle freigegebenen Veranstaltungen ab heute.

Eine Beispielantwort sieht so aus:

{
  "workspace": "dein-workspace",
  "count": 2,
  "events": [
    {
      "id": "…",
      "title": "Sommerkonzert",
      "description": "…",
      "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",
      "updated_at": "2026-08-05T09:00:00Z"
    }
  ]
}

Für Entwickler und Agenturen

Der Feed ist bewusst so gebaut, dass er sich direkt in eine bestehende Website integrieren lässt, ohne Zugangsdaten zu verwalten:

• Kein Auth, kein API-Key — die Route ist öffentlich erreichbar, liefert aber ausschließlich Veranstaltungen mit aktiviertem Schalter des jeweiligen Workspaces.
• CORS ist offen, ein Abruf per fetch funktioniert direkt aus dem Browser jeder Website.
• Gecacht — Antworten sind kurz cachebar (wenige Minuten), damit häufige Abrufe schnell bleiben. Eine frisch freigegebene Veranstaltung erscheint dadurch nicht sofort, sondern innerhalb weniger Minuten.
• Rate-limitiert — bei sehr vielen Abrufen in kurzer Zeit von derselben Quelle antwortet die Route mit einem Fehler statt mit leeren Daten; für normale Website-Nutzung ist das nicht relevant.
• Ein unbekannter Workspace-Slug liefert einen Fehler, keine leere Liste — so merkst du sofort, wenn der Slug falsch ist.

Häufige Fragen

Sehe ich im Feed auch Locations, die nur belegt, aber nicht öffentlich geschaltet sind? Nein. Der Feed zeigt ausschließlich Veranstaltungen, bei denen du den Schalter Auf Website zeigen aktiv gesetzt hast — nie deine allgemeine Locations-Auslastung.

Enthält der Feed Preise? Nicht direkt. Er liefert einen Link zum Ticketverkauf (ticket_url), falls die Veranstaltung eine Buchungsseite mit Ticketverkauf hat — die eigentlichen Preise stehen auf dieser Buchungsseite.

Muss ich für jede Veranstaltung einzeln freigeben? Ja, aktuell gibt es keine Sammel-Freigabe. Der Schalter sitzt bewusst an jeder Veranstaltung einzeln, damit du volle Kontrolle darüber hast, was öffentlich sichtbar ist.

Ist die Funktion an einen bestimmten Plan gebunden? Der Feed zeigt ausschließlich, was du selbst freigibst — es gibt keine zusätzlichen Voraussetzungen über die normale Event-Berechtigung hinaus.

Kostet der Aufruf des Feeds mich etwas? Nein, der Feed ist ein reiner Lesezugriff auf Daten, die du bereits freigegeben hast — es fallen keine gesonderten Kosten an.