# Erste Schritte

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

## Hinweise für KI-Agenten

- API-Basisadresse: `https://api.eventwerk.eu/api/v1`
- OpenAPI 3.1: `https://api.eventwerk.eu/openapi.json` und `/api/v1/openapi.json`. Daraus lassen sich Clients und Typprüfungen generieren.
- Anmeldung: `Authorization: Bearer ew_...`
- Schlüssel: Einstellungen unter `/dashboard/einstellungen`, nur mit Eventwerk Plus und nur für Eigentümer. Der volle Schlüssel wird nur einmal angezeigt. Name und Zeitpunkt der letzten Nutzung werden geführt und ausgegeben.
- Zeiten: Alle Zeitpunkte kommen in UTC mit Suffix `Z`. Die Zeitzone des Events steht getrennt in `timezone` als IANA-Name, Standard `Europe/Vienna`. Clients rechnen selbst um.
- Paginierung: Die Event- und Anmeldelisten liefern `{items, has_more, next_cursor}` mit `limit` (Standard 50, höchstens 200), `cursor` und `updated_since`.
- Grenzen: 200 Anfragen pro Minute je Schlüssel. Der Zähler liegt im Speicher je Instanz, ist hinter mehreren Instanzen ein Vielfaches und beginnt nach einem Deploy neu. Bei Überschreitung antwortet die API mit 429, `rate_limited` und `Retry-After`.
- Gastgrenzen: Anmelde-Link 20 je Stunde je IP-Adresse, Anmeldung 60 je Stunde je IP-Adresse und 3 je Stunde je E-Mail-Adresse und Event.
- Fehler: JSON mit `code` und `message`, optional mit `details`.

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.

> **Warnung:** 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`.