Nach 5 fehlgeschlagenen Login-Versuchen wird eine IP für 15 Minuten gesperrt. Hier können aktive Sperren vorzeitig aufgehoben werden.

Externe Anwendungen authentifizieren sich über den HTTP-Header X-API-Key (alternativ Authorization: Bearer …). Der Klartext-Schlüssel wird nur unmittelbar nach der Erstellung angezeigt – notieren Sie ihn sicher, denn er kann später nicht erneut eingesehen werden.

Es wurden noch keine API-Schlüssel erstellt.

Alle Endpunkte werden per POST als JSON an /api.php gesendet – das Feld action bestimmt den aufgerufenen Endpunkt. Zur Authentifizierung senden Sie einen gültigen API-Schlüssel im Header X-API-Key (alternativ Authorization: Bearer IHR_SCHLÜSSEL). Ohne gültigen Schlüssel antwortet die API mit Status 401.

1. Veranstaltungen abrufen

action: "api_get_events" – liefert alle künftigen Veranstaltungen inklusive der Anzahl noch verfügbarer Plätze.

curl -X POST https://IHRE-DOMAIN/api.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: IHR_SCHLÜSSEL" \
  -d '{"action": "api_get_events"}'

{
  "success": true,
  "events": [
    {
      "id": "a1b2c3d4e5f60718",
      "name": "Sommerfest",
      "description": "…",
      "location": "Vereinsheim",
      "date": "2026-07-12",
      "time": "18:00",
      "tickets_required": 1,
      "price": "5.00",
      "ticket_link": null,
      "max_tickets": 100,
      "registration_deadline": "2026-07-05",
      "booking_closed": 0,
      "is_cancelled": 0,
      "tickets_available": 42
    }
  ]
}

Hinweis: tickets_available ist null, wenn die Veranstaltung kein Kartenlimit (max_tickets) besitzt. is_cancelled: 1 bedeutet, dass die Veranstaltung abgesagt wurde – Anmeldungen über api_register werden dann mit HTTP 409 abgewiesen.

2. Angemeldete Personen abrufen

action: "api_get_attendees" – liefert die Namen und Anmeldezeitpunkte aller für eine Veranstaltung angemeldeten Personen (ohne E-Mail-Adressen).

curl -X POST https://IHRE-DOMAIN/api.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: IHR_SCHLÜSSEL" \
  -d '{"action": "api_get_attendees", "event_id": "a1b2c3d4e5f60718"}'

{
  "success": true,
  "attendees": [
    { "name": "Max Mustermann", "registered_at": "2026-06-01 10:15:32" }
  ]
}

3. Anmeldung erstellen

action: "api_register" – meldet eine Person zu einer Veranstaltung an. Es gelten dieselben Prüfungen wie im Anmeldeformular (Kartenlimit, Anmeldefrist, Buchungssperre, Mehrfachanmeldung mit derselben E-Mail-Adresse). Das Feld tickets ist nur bei Veranstaltungen mit Ticketpflicht (tickets_required: true) erforderlich – bei Veranstaltungen ohne Ticketpflicht kann es weggelassen werden, die Anmeldung erfolgt dann automatisch mit 1 Karte.

curl -X POST https://IHRE-DOMAIN/api.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: IHR_SCHLÜSSEL" \
  -d '{
    "action": "api_register",
    "event_id": "a1b2c3d4e5f60718",
    "name": "Max Mustermann",
    "email": "max@example.com",
    "tickets": 2,
    "binding_confirmed": true
  }'

{ "success": true, "message": "Erfolgreich angemeldet!" }

Fehlerantworten

Bei Fehlern liefert die API "success": false sowie eine sprechende message und einen passenden HTTP-Status-Code: 401 (Schlüssel fehlt/ungültig/widerrufen), 404 (Veranstaltung nicht gefunden), 409 (z. B. Veranstaltung abgesagt, ausgebucht, Anmeldefrist abgelaufen, bereits angemeldet) sowie 400 bei fehlerhaften Eingaben.