Listen

Listen gruppieren deine Veranstaltungen in eigene Kalender. Eine öffentliche Liste erscheint auf deiner Anbieterseite und kann abonniert werden. „Public" ist die Standardliste für nicht zugeordnete Veranstaltungen.

Listen auflisten

GET /api/lists

{
  "data": {
    "lists": [
      { "id": 4, "name": "Konzerte", "public": true, "token": "…", "eventCount": 12 }
    ]
  }
}

Der token verlinkt auf die öffentliche Listenseite (/liste/:token).

Liste anlegen

POST /api/lists – idempotent pro Name: existiert eine gleichnamige Liste, wird sie zurückgegeben statt eine zweite anzulegen.

curl -X POST https://eventfalcon.de/api/lists \
  -H "Authorization: Bearer ef_dein_schluessel" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Konzerte" }'

{ "data": { "list": { "id": 4, "name": "Konzerte", "token": "…" } } }

Liste aktualisieren

PATCH /api/lists/:id – setze name und/oder public:

curl -X PATCH https://eventfalcon.de/api/lists/4 \
  -H "Authorization: Bearer ef_dein_schluessel" \
  -H "Content-Type: application/json" \
  -d '{ "public": true }'

Liste löschen

DELETE /api/lists/:id – die enthaltenen Veranstaltungen bleiben erhalten und fallen zurück in die Standardliste „Public".

Um eine Veranstaltung einer Liste zuzuordnen, sende beim Anlegen oder Bearbeiten das Feld listId mit (siehe Veranstaltungen).