Dokumentation

Gäste-Import und Empfehlungen

Anmeldungen per CSV importieren und Empfehlungscodes für Gäste nutzen.

Neben der Gästeliste und dem CSV-Export gibt es den CSV-Import und Empfehlungscodes. Beide laufen über die Sitzungs-API und sind nicht Teil der öffentlichen API unter /api/v1.

CSV-Import

Die Vorlage liegt unter GET /api/events/{eventID}/registrations/import/template.csv. Sie enthält ein Byte Order Mark und die Spalten name, email, ticket, promo_code und referral_code.

POST /api/events/{eventID}/registrations/import/preview prüft die Datei, ohne etwas zu speichern.
POST /api/events/{eventID}/registrations/import legt die gültigen Zeilen an.
Die Datei wird als Multipart-Feld file gesendet.
Erlaubt sind höchstens 2 MB und 5000 Datenzeilen.
Pflicht sind die Spalten name und email. Weitere Spalten sind optional.
Doppelte E-Mail-Adressen in der Datei und bereits vorhandene Anmeldungen werden übersprungen.
Unbekannte oder leere Ticketnamen verwenden die Ticketart Standard. Fehlt diese, schlägt die Zeile mit ticket_not_found fehl.
Ungültige Namen oder E-Mail-Adressen erscheinen als Fehler mit Zeilennummer.
Bei Events mit Zugangscode wird jede Zeile mit access_code_required abgelehnt.
Importierte Gäste erhalten keine E-Mail.

Die Antwort des Imports enthält created, skipped, failed, errors und note. Die Vorschau liefert columns, die ersten 10 rows, errors und total_rows.

Die Vorschau speichert nichts. Eine eigene Oberfläche für den Import ist noch nicht gebaut; die Verwaltung läuft über die API.

Empfehlungscodes

Jede Anmeldung kann einen Empfehlungscode erhalten. Der Code gilt nur für das Event und ist acht Zeichen lang. Ein erneuter Aufruf liefert denselben Code. Die Antwort enthält referral_code und share_url.

Methode	Pfad	Zweck
POST	/api/events/{eventID}/registrations/{registrationID}/referral	Empfehlungscode erzeugen oder lesen.
GET	/api/events/{eventID}/referrals	Empfehlungen mit eingeladenen und angemeldeten Personen lesen.

Die geteilte Adresse lautet /e/<slug>?ref=<code>. Bei der öffentlichen Anmeldung wird der Code als referral_code mitgeschickt. Ein unbekannter Code bricht die Anmeldung nicht ab; die Zuordnung fehlt dann.

Der Empfehlungscode steht in der Gästeliste bei der eingeladenen Anmeldung.
Die Auswertung enthält referrer_name, referrer_email, code, invited_count und registered_count.
invited_count zählt offene, bestätigte und wartende Anmeldungen, registered_count nur bestätigte.
Alle Endpunkte dieser Seite brauchen ein Sitzungs-Token und die Rolle Eigentümer oder Verwaltung.

Die öffentliche Anmeldung im Frontend sendet derzeit keinen Empfehlungscode mit. Die Zuordnung ist über die API möglich. Eine Oberfläche für Empfehlungen ist noch nicht gebaut.