Zurück zur Übersicht

Dokumentation

Anmeldung und Warteliste

Als Text für KI-Agenten

Wie Gäste sich anmelden, wann Freigabe oder Zugangscode nötig sind und wie die Warteliste greift.

Gäste brauchen kein Konto. Die Anmeldung läuft über die öffentliche Eventseite /event/<slug>. Dort wählen sie eine Ticketart, tragen Name und E-Mail-Adresse ein, beantworten die Fragen und bestätigen die Datenschutzhinweise.

Pflichtangaben

  • Name und E-Mail-Adresse.
  • Eine aktive, nicht verborgene Ticketart. Ohne Auswahl wird die erste sichtbare Ticketart verwendet.
  • Die Zustimmung zu den Datenschutzhinweisen.
  • Antworten auf alle Pflichtfragen.
  • Bei Anmeldungen mit Zugangscode zusätzlich der Zugangscode.

Mehrere Tickets in einer Buchung

Über POST /api/public/events/{slug}/register kann eine Person weitere Tickets für andere mitbuchen. Im Feld attendees stehen bis zu 9 weitere Personen mit name und email, beide Pflicht. Jede mitgebuchte Person erhält eine Nachricht mit ihrem eigenen Ticket, die die anmeldende Person nennt. Mit attendees_authorized: true bestätigen Sie, dass Sie zur Angabe dieser Daten befugt sind; ohne Bestätigung lehnt die API mit attendees_authorization_required ab.

  • Jede mitgebuchte Person ist eine eigene Anmeldung mit eigenem qr_token und wird unabhängig eingecheckt.
  • Eine Zahlung deckt die ganze Buchung.
  • Eine Buchung zählt mit allen Sitzen. Passt sie nicht mehr vollständig in das Kontingent, geht sie geschlossen auf die Warteliste.
  • Die buchende Person erhält eine Bestätigung mit allen Tickets und leitet die Links weiter.
  • Jede mitgebuchte Person erhält zusätzlich eine kurze Information mit ihrem eigenen Ticketlink. Darin steht ausdrücklich, wer sie angemeldet hat, mit dem Hinweis, sich beim Veranstalter zu melden, wenn das nicht richtig ist. So erfährt niemand ohne sein Wissen, dass seine Daten weitergegeben wurden.
  • Name und E-Mail-Adresse sind bei jeder mitgebuchten Person Pflicht.

Die Antwort enthält seats mit der Zahl aller Sitze der Buchung, attendees mit id, name, qr_token und status je mitgebuchter Person sowie attendees_authorized_at mit dem Zeitpunkt der Befugnisbestätigung.

Bestätigung und Ticket

Nach der Anmeldung sendet Eventwerk eine Bestätigungsmail. Der Link /ticket/<token> enthält das Ticket mit QR-Code. Der Token ist ein Geheimnis und darf nicht weitergegeben werden. Bei Freigabe nötig entfällt das Ticket zunächst: Die Anmeldung wartet auf die Entscheidung des Veranstalters, erst danach entsteht ein Ticket.

Erinnerungen vor dem Event enthalten eine Rückfrage, ob der Gast kommt. Die Antworten und ihre Folgen für die Warteliste stehen unter Erinnerungen und Rückfrage.

  • Gäste können ihr Ticket aufrufen, ihre Anmeldung stornieren oder ihre Daten endgültig löschen.
  • Stornieren ist nur solange möglich, wie die Anmeldung nicht eingecheckt ist.
  • Nach dem Löschen sind die Anmeldung, ihre Antworten und ihre Favoriten entfernt.

Grenzen

Öffentliche Anmeldeversuche sind je IP-Adresse begrenzt. Darüber antwortet der Dienst mit Status 429.

  • Anmeldung zu einem Event: 60 Anfragen pro Stunde je IP-Adresse.
  • Zusätzlich höchstens 3 Anmeldungen pro Stunde je E-Mail-Adresse und Event.

Warteliste

Ist das Kontingent einer Ticketart oder die Kapazität des Events erreicht, entsteht eine Anmeldung mit Status waitlisted. Ein fester Platz ist damit nicht reserviert.

  • Wird eine bestätigte Anmeldung storniert, rückt die älteste wartende Anmeldung derselben Ticketart nach.
  • Nachgerückte Anmeldungen werden bestätigt. Die erste nachgerückte Person erhält zusätzlich eine Nachricht mit ihrem Ticket.
  • Ein Platz wird nur frei, wenn eine bestätigte Anmeldung storniert wird. Die Stornierung einer wartenden Anmeldung löst kein Nachrücken aus.
  • Wartende Anmeldungen können nicht eingecheckt werden.

Status

StatusBedeutung
pendingWartet auf Freigabe. Entsteht, wenn der Anmeldemodus Freigabe nötig ist.
confirmedBestätigt, ein Platz ist reserviert.
waitlistedWarteliste, kein fester Platz.
cancelledStorniert.
declinedVom Veranstalter abgelehnt.

Pro Event lässt sich der Anmeldemodus wählen: Sofort bestätigen, Freigabe nötig oder Nur mit Zugangscode. Bei Freigabe nötig entscheidet das Team in der Gästeliste über jede offene Anmeldung. Bei Nur mit Zugangscode verlangt die öffentliche Anmeldung den gespeicherten Code; der Code selbst erscheint nicht in der öffentlichen Eventantwort.

Sperren der Anmeldung

Die öffentliche Anmeldung wird in mehreren Fällen gesperrt. Die Antwort nennt immer einen stabilen Code.

  • event_ended (409): Anmeldung nach dem Terminende. Maßgeblich ist end_at, sonst start_at.
  • already_registered (409): Dieselbe E-Mail-Adresse hat schon eine aktive Anmeldung. details.email nennt sie.
  • attendee_email_duplicate (409): Eine mitgebuchte Adresse gehört bereits zur Buchung oder ist schon angemeldet. details.email nennt sie.
  • attendees_authorization_required (400): Mitgebuchte Personen ohne Befugnisbestätigung.
  • attendee_name_required (400): Eine mitgebuchte Person ohne Namen.
  • attendee_email_required (400): Eine mitgebuchte Person ohne E-Mail-Adresse. Die Adresse ist bei jeder mitgebuchten Person Pflicht, weil sie über die Anmeldung informiert wird.
  • attendee_email_invalid (400): Ungültige Adresse einer mitgebuchten Person.
  • too_many_attendees (400): Mehr als 9 mitgebuchte Personen.

Eigene Fragen

Pro Event lassen sich Fragen anlegen, wahlweise für alle Ticketarten oder für eine bestimmte Ticketart. Unterstützt werden Text, mehrzeiliger Text, Auswahl mit mindestens zwei Optionen, Ja/Nein, Telefonnummer und Webadresse.

  • Pflichtfragen müssen beantwortet werden, sonst antwortet die API mit question_required.
  • Antworten erscheinen in den Gastdetails und als zusätzliche Spalten im CSV-Export.
  • Die Reihenfolge steuert die Anzeige im Formular.

Stornieren durch das Team

Eigentümer und Verwaltung können Anmeldungen in der Gästeliste stornieren. Eine eingecheckte Anmeldung lässt sich nur mit einer ausdrücklichen Bestätigung stornieren. Beim Stornieren wird die Warteliste automatisch nachgezogen.

Bezahlte Tickets sind noch nicht freigeschaltet. Eine Anmeldung mit einem Preis größer als null wird mit payment_not_available abgelehnt.