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
| Feld | Pflicht | Inhalt |
|---|---|---|
title | ja | Titel, 3 bis 200 Zeichen |
start | ja | Beginn, z. B. 2027-07-17T20:00 (Ortszeit) oder 2027-07-17 ohne Uhrzeit |
end | nein | Ende im selben Format |
venue | nein | Name der Spielstätte |
address | ja* | Straße, PLZ und Ort |
city, postalCode | ja* | Ort und PLZ, falls keine vollständige Adresse (*eines davon genügt) |
url | nein | Seite mit Infos oder Tickets |
description | nein | Kurzbeschreibung, höchstens 400 Zeichen |
category | nein | konzert, party, theater, musical, comedy, kino, ausstellung, messe, fest, sport, familie, bildung, sonstiges |
price | nein | Preisangabe als Text, z. B. „ab 18 €“ |
isFree | nein | true bei freiem Eintritt |
status | nein | scheduled, 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.