Event-API Dokumentation

Der Leitfaden für den vollautomatisierten Import von Veranstaltungen in das festia.de Netzwerk.

🚀 Einführung

Mit der festia.de Event-API können Sie als Veranstalter, Agentur oder Ticketing-Dienstleister Ihre Events vollautomatisch zu festia.de übertragen. Jedes übertragene Event wird in eine Warteschlange gelegt, von unserer KI automatisch kategorisiert und zur Veröffentlichung vorbereitet.

🛡️ Authentifizierung
Jeder API-Aufruf muss authentifiziert werden. Senden Sie dazu Ihren API-Schlüssel im Header X-API-KEY mit. Den API-Schlüssel können Sie in Ihrem festia.de Account unter "Meine Events -> API Import" generieren.

📤 Event Importieren

Erstellt ein neues Event in Ihrem Account. Das Event erhält initial den Status "Zur Prüfung".

POST https://eventapi.festia.de/v1/events/import.php

Header

Content-Type: application/json
X-API-KEY: fst_live_ihr_api_schluessel_hier

Payload (JSON)

Sie können eine flache JSON-Struktur oder eine logisch verschachtelte Struktur (z.B. location: {...}) nutzen.

Feld Typ Beschreibung
title oder name PFLICHT String Der Name / Titel der Veranstaltung.
start_datetime PFLICHT String Startzeitpunkt (ISO 8601, z.B. 2026-08-15T18:00:00)
end_datetime PFLICHT String Endzeitpunkt (ISO 8601, z.B. 2026-08-16T02:00:00)
description PFLICHT String Ausführliche Beschreibung des Events. (URLs werden automatisch gefiltert).
📍 Standort (Location)
zip oder postal_code PFLICHT String Postleitzahl des Veranstaltungsortes.
city oder addressLocality PFLICHT String Ort / Stadt.
address oder streetAddress PFLICHT String Straße und Hausnummer.
latitude / longitude Float Geodaten (Optional). Wenn nicht übergeben, ermitteln wir diese automatisch im Hintergrund.
👤 Veranstalter (Organizer)
organizer_name String Offizieller Name des Veranstalters.
organizer_email / organizer_phone String Weitere Kontaktdaten des Veranstalters.
📋 Weitere optionale Felder
cost String Kosten (z.B. "15,00 €" oder "Eintritt frei").
image_url String URL zu einem Titelbild. Das Bild wird asynchron von uns heruntergeladen.
format_indoor, format_outdoor Int (0/1) Art der Veranstaltung (1 = Ja).
wheelchair_accessible Int (0/1) Barrierefreiheit.
homepage_link, ticket_link String Externe Links zum Event.

Beispiel Request (cURL)

curl -X POST https://eventapi.festia.de/v1/events/import.php \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: fst_live_1234567890abcdef" \
  -d '{
    "title": "Sommerfest im Park 2026",
    "start_datetime": "2026-07-20T14:00:00",
    "end_datetime": "2026-07-20T23:00:00",
    "zip": "10115",
    "city": "Berlin",
    "address": "Musterpark 1",
    "description": "Das große Sommerfest mit Live-Musik. Kommt vorbei!",
    "cost": "Eintritt frei",
    "organizer_name": "Event Agentur Berlin",
    "image_url": "https://example.com/images/sommerfest.jpg"
  }'

Antwort (Erfolg)

HTTP/1.1 201 Created
{
  "status": "success",
  "message": "Event imported successfully.",
  "event_id": 1042
}

🧪 API Test-Modus

Um Ihre Integration gefahrlos zu testen, können Sie Payloads an unseren Test-Endpunkt senden. Diese Daten werden nicht live geschaltet, sondern nur in Ihrem Dashboard als "Gültig" oder "Fehlerhaft" inklusive einer Fehleranalyse angezeigt.

POST https://eventapi.festia.de/v1/events/test_import.php

Senden Sie genau denselben Payload wie für die Live-API. Loggen Sie sich anschließend in Ihren festia.de Account ein und öffnen Sie Meine Events → Entwickler / API. Dort sehen Sie das Ergebnis im API Test-Monitor.