Eventwerk
Zurück zur Übersicht

Dokumentation

Erste Schritte

Als Text für KI-Agenten

Konto, erstes Event und der Einstieg in die Arbeit mit einem KI-Agenten.

Eventwerk bündelt Anmeldung, Gästeliste, Nachrichten und den Überblick über Ihre Veranstaltungen. Die Oberfläche ist auf Deutsch, die Daten liegen in der Europäischen Union.

Konto und Anmeldung

Die Anmeldung funktioniert ohne Passwort. Sie geben auf /login Ihre E-Mail-Adresse ein und erhalten einen Anmelde-Link. Der Link ist 15 Minuten gültig und kann nur einmal verwendet werden.

  • Beim ersten bestätigten Link entsteht automatisch eine Organisation.
  • Sie werden Eigentümer dieser Organisation und können später weitere Personen einladen.
  • Die Sitzung bleibt über ein Refresh-Token erhalten. Das Access-Token gilt 15 Minuten.
  • Das Anfordern eines Anmelde-Links ist auf 20 Anfragen pro Stunde je IP-Adresse begrenzt.

Event anlegen

Ein Event lässt sich ohne Konto unter /erstellen anlegen. Alternativ legen Sie es nach der Anmeldung im Dashboard unter /dashboard/events/new an.

  • Ohne Anmeldung entsteht zunächst ein Entwurf. Erst nach der Bestätigung des Anmelde-Links wird das Event veröffentlicht.
  • Im Dashboard wählen Sie den Status selbst: Entwurf oder veröffentlicht.
  • Jedes neue Event erhält automatisch eine freie Ticketart mit dem Namen Standard.

Das Dashboard

  • Übersicht: Kennzahlen, kommende Events und offene Aufgaben.
  • Events: anlegen, bearbeiten, duplizieren und löschen.
  • Gäste und Einlass: Anmeldungen lesen, filtern, exportieren und einchecken.
  • Nachrichten: E-Mails an Empfängergruppen entwerfen, planen und versenden.
  • Team: Rollen und Einladungen verwalten.
  • Einstellungen: Organisation, Plan und API-Schlüssel.
  • Benachrichtigungen: Meldungen der Organisation mit Ungelesen-Zähler.

Mit einem KI-Agenten arbeiten

Für Automatisierung gibt es die öffentliche API unter /api/v1. Sie gehört zu Eventwerk Plus und wird mit einem API-Schlüssel angesprochen. Ein Schlüssel handelt mit den Rechten des Eigentümers.

  1. Stellen Sie den Plan in den Einstellungen auf Eventwerk Plus. Der Wechsel ist derzeit kostenlos.
  2. Legen Sie unter Einstellungen, API-Schlüssel einen Schlüssel an. Der volle Schlüssel wird nur einmal angezeigt.
  3. Prüfen Sie den Schlüssel mit GET https://api.eventwerk.eu/api/v1/me. Die Antwort enthält Organisation und Rolle.
  4. Lesen Sie Events mit GET https://api.eventwerk.eu/api/v1/events und legen Sie Events mit POST https://api.eventwerk.eu/api/v1/events an.
  5. Lesen Sie Anmeldungen mit GET https://api.eventwerk.eu/api/v1/events/{eventID}/registrations.
bash
curl -s https://api.eventwerk.eu/api/v1/me \
  -H "Authorization: Bearer ew_..."

Anmeldungen lassen sich über die öffentliche API lesen. Das Anlegen und Stornieren läuft über die öffentliche Eventseite und das Ticket.

Der Schlüssel handelt mit den Rechten des Eigentümers. Bewahren Sie ihn sicher auf und schreiben Sie ihn nicht in Protokolle, Repositorys oder öffentliche Konfigurationen.

Es gelten 200 Anfragen pro Minute je Schlüssel, gezählt im Speicher jeder Instanz. Fehler kommen als JSON mit code und message. Die vollständige Referenz steht unter /docs/api-grundlagen, /docs/api-ereignisse und /docs/api-fehler.