wasgehtbayern.de

Für Veranstalter

Deine Events gehören hierher. Es gibt zwei Wege, und beide kosten dich nichts.

1. Automatisch über deine Website

Steht dein Programm auf deiner Website, lesen wir es regelmäßig aus und verlinken auf dich. Am zuverlässigsten klappt das, wenn die Seite strukturierte Daten nach schema.org/Event enthält. Fehlt deine Seite noch oder stimmt etwas nicht? Schreib an dominik.hoefling@outlook.com.

2. Direkt über die Schnittstelle

Wer viele Termine hat oder sie aus einem eigenen System heraus melden will, trägt sie über unsere Schnittstelle ein. Den Schlüssel dafür vergeben wir auf Anfrage per E-Mail an dominik.hoefling@outlook.com. Nenne uns kurz, wer du bist und welche Art von Events du einträgst.

Ein Event eintragen:

curl -X POST https://wasgehtbayern.de/api/v1/events \
  -H "Authorization: Bearer ev_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Sommernachtskonzert im Schlosshof",
    "start": "2027-07-17T20:00",
    "end": "2027-07-17T23:00",
    "venue": "Schlosshof",
    "address": "Schlossplatz 1, 91522 Ansbach",
    "url": "https://www.example.org/sommernachtskonzert",
    "description": "Open-Air-Konzert mit regionalen Bands.",
    "category": "konzert",
    "price": "ab 18 €"
  }'

Die Antwort enthält die Kennung des Events und die Adresse seiner Seite bei uns. Schickst du dasselbe Event erneut (gleicher Titel, Tag und Ort), wird es aktualisiert statt doppelt angelegt.

Felder

FeldPflichtInhalt
titlejaTitel, 3 bis 200 Zeichen
startjaBeginn, z. B. 2027-07-17T20:00 (Ortszeit) oder 2027-07-17 ohne Uhrzeit
endneinEnde im selben Format
venueneinName der Spielstätte
addressja*Straße, PLZ und Ort
city, postalCodeja*Ort und PLZ, falls keine vollständige Adresse (*eines davon genügt)
urlneinSeite mit Infos oder Tickets
descriptionneinKurzbeschreibung, höchstens 400 Zeichen
categoryneinkonzert, party, theater, musical, comedy, kino, ausstellung, messe, fest, sport, familie, bildung, sonstiges
priceneinPreisangabe als Text, z. B. „ab 18 €“
isFreeneintrue bei freiem Eintritt
statusneinscheduled, cancelled oder postponed

Weitere Aufrufe

POST /api/v1/events nimmt auch mehrere Events auf einmal: {"events": [ … ]}, höchstens 25 pro Anfrage.
GET /api/v1/events listet deine kommenden Events.
DELETE /api/v1/events?id=… zieht ein Event zurück. Für eine Absage schickst du es stattdessen erneut mit "status": "cancelled", dann sehen Besucher den Hinweis.

Spielregeln

Eingetragen werden öffentliche Veranstaltungen in Bayern, für die du verantwortlich bist. Pro Schlüssel sind 30 Anfragen in der Minute und 100 neue Events am Tag möglich; brauchst du mehr, sag Bescheid. Bei Missbrauch sperren wir den Schlüssel und entfernen die Einträge.