Dokumentation
Anmeldung und Warteliste
Als Text für KI-AgentenWie 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_tokenund 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
| Status | Bedeutung |
|---|---|
| pending | Wartet auf Freigabe. Entsteht, wenn der Anmeldemodus Freigabe nötig ist. |
| confirmed | Bestätigt, ein Platz ist reserviert. |
| waitlisted | Warteliste, kein fester Platz. |
| cancelled | Storniert. |
| declined | Vom 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 istend_at, sonststart_at.already_registered(409): Dieselbe E-Mail-Adresse hat schon eine aktive Anmeldung.details.emailnennt sie.attendee_email_duplicate(409): Eine mitgebuchte Adresse gehört bereits zur Buchung oder ist schon angemeldet.details.emailnennt 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.