Veranstaltungen

Endpunkte zum Verwalten deiner Veranstaltungen. Jede Anfrage benötigt einen gültigen API-Schlüssel.

Endpunkte im Überblick

Veranstaltung anlegen

POST /api/events

curl -X POST https://eventfalcon.de/api/events \
  -H "Authorization: Bearer ef_dein_schluessel" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Sommerkonzert",
    "location": "Rathausplatz, Düsseldorf",
    "startDate": "2026-08-15",
    "startTime": "19:30",
    "visibility": "public"
  }'

Antwort 201:

{ "data": { "id": 123 } }

Felder

Agenda (agenda)

Der Ablauf eines Termins als Liste von Programmpunkten, in der Reihenfolge, in der sie erscheinen sollen (es wird nicht nach Uhrzeit sortiert):

"agenda": [
  { "time": "18:00", "timeEnd": "18:15", "title": "Einlass & Begrüßung" },
  { "time": "18:15", "timeEnd": "19:30", "title": "Vortrag", "text": "Referentin: Jana Albers" },
  { "title": "Pause" }
]

Ein Punkt braucht title oder text; leere Punkte werden verworfen. Höchstens 50 Punkte. Wie bei den übrigen Feldern ersetzt ein Bearbeiten die Agenda vollständig: Wer agenda weglässt, entfernt sie. Mit scope: "single" bekommt ein einzelner Termin einer Serie seine eigene Agenda.

Beim Lesen steht die Agenda an jedem Termin: GET /api/events und GET /api/events/:id liefern in occurrences[] das Feld agenda — die eigene des Termins, sonst die der Veranstaltung, und [], wenn es keine gibt.

Abonnenten sehen die Agenda auch in ihrem Kalender: Sie steht im Beschreibungstext des jeweiligen Kalendereintrags, unter der Beschreibung.

Wiederholung (recurrence)

Für Serientermine. Weglassen für Einzeltermine.

{
  "recurrence": {
    "freq": "weekly",
    "interval": 1,
    "days": [1, 3],
    "endType": "until",
    "until": "2026-12-31"
  }
}

Veranstaltungen auflisten

GET /api/events liefert alle eigenen Veranstaltungen samt aufgelöster Termine:

{ "data": { "events": [ { "id": 123, "title": "…", "occurrences": [ … ] } ] } }

Bearbeiten

POST /api/events/:id/update-occurrence

Der Body enthält dieselben Felder wie beim Anlegen, zusätzlich einen scope und – außer bei scope: "all" – die occurrenceStart des betroffenen Termins (YYYY-MM-DDTHH:MM:SS).

curl -X POST https://eventfalcon.de/api/events/123/update-occurrence \
  -H "Authorization: Bearer ef_dein_schluessel" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "all", "title": "Sommerkonzert (Open Air)", "startDate": "2026-08-15", "startTime": "20:00" }'

Termin hinzufügen

POST /api/events/:id/add-occurrence fügt einer Veranstaltung einen weiteren Termin hinzu. Der Body entspricht dem Anlegen (Datum/Uhrzeit + Felder).

Absagen (statt löschen)

Wenn ein Termin abgesagt wird, bleibt er erhalten – im Gegensatz zum Löschen. Abonnent/innen erhalten dadurch in ihrem Kalender eine STATUS:CANCELLED-Aktualisierung (der Termin verschwindet also nicht kommentarlos), und auf der Website wird er als „Abgesagt" mit optionaler Begründung angezeigt. Nutze Löschen nur, um eine Veranstaltung wirklich spurlos zu entfernen (z. B. Fehleingaben).

POST /api/events/:id/cancel-occurrence

curl -X POST https://eventfalcon.de/api/events/123/cancel-occurrence \
  -H "Authorization: Bearer ef_dein_schluessel" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "single", "occurrenceStart": "2026-08-22T19:30:00", "reason": "Wegen schlechten Wetters abgesagt" }'

Ein einzelner abgesagter Termin (scope: "single") eignet sich z. B., wenn ein Termin einer Serie wegen schlechten Wetters ausfällt; all sagt die gesamte Veranstaltung ab. Import-Schnittstellen legen Veranstaltungen an – Absagen erfolgen anschließend über diesen Endpunkt.

Termin löschen

POST /api/events/:id/delete-occurrence

curl -X POST https://eventfalcon.de/api/events/123/delete-occurrence \
  -H "Authorization: Bearer ef_dein_schluessel" \
  -H "Content-Type: application/json" \
  -d '{ "scope": "single", "occurrenceStart": "2026-08-22T19:30:00" }'

scope verhält sich wie beim Bearbeiten. Bei all wird die gesamte Veranstaltung entfernt.