VK Exportschnittstelle Version 3.3 vom 14.07.2026

Weitere Exporte

Neben der Listenansicht gibt es noch weitere Exporte, die über den Parameter "TYP=xxxx" ausgewählt werden können:

TYP=ARTEN

Was: Gibt alle Veranstaltungsarten, inkl. Unterarten und jeweiliger ID.

Format: JSON

Login erforderlich: nein

TYP=DETAIL

Weitere Paramter: "VERANSTALTUNGID=y" (notwendig!)

Was: Gibt die Details der Veranstaltung mit der VeranstaltungsID y aus.

Format: JSON / XML

Login erforderlich: ja

TYP=FAVORITEN

Weitere Paramter: "FAVORITENLISTE=yyy" (notwendig!)

Was: Gibt alle Veranstaltungen der Favoritenliste yyy des Benutzter aus.

Format: JSON / XML

Login erforderlich: ja

TYP=KATEGORIEN

Was: Gibt alle Veranstaltungskategorien, inkl. Unterkategorien und jeweiliger ID.

Format: JSON

Login erforderlich: nein

TYP=ORTE

Was: Gibt Veranstaltungsorte inkl. aller Ortsdaten als JSON-Objekt aus, indiziert nach der Veranstaltungsort-ID.

Standardmäßig werden alle Veranstaltungsorte ausgegeben. Mit NUREIGENE=1 wird auf die dem angemeldeten Benutzer zugeordneten Orte (Orts- bzw. Stadt-/PLZ-Rechte) eingeschränkt.

Weitere Parameter (optional):

Parameter Typ Beschreibung
SUCHTEXT string Filtert nach Ortsname (namekomplett, d.h. Name und ggfs. Zusatz, getrennt durch einen Bindestrich). Ist der Wert numerisch, wird zusätzlich nach der Veranstaltungsort-ID gesucht.
NUREIGENE bool 1: nur die dem Benutzer zugeordneten Orte
0 / nicht gesetzt: alle Orte

Format: JSON

Login erforderlich: ja (ohne gültigen Login liefert die Abfrage {no login})

Ausgabe: JSON-Objekt { "<ortID>": { … } }, je Ort mit folgenden Feldern:

Feld Typ Beschreibung
name string Ortsname
zusatz string Namenszusatz
namekomplett string Vollständiger Name (Name + Zusatz, getrennt durch Bindestrich)
strassenr string Straße und Hausnummer
plz string Postleitzahl
ort string Ort/Stadt
email string E-Mail-Adresse
internet string Webadresse
lat float Breitengrad
lng float Längengrad
telefon string Telefonnummer
telefax string Faxnummer
vgn string Anbindung öffentlicher Nahverkehr (VGN)
oeffnungszeiten string Öffnungszeiten
zugaenglichkeit object Barrierefreiheit (siehe unten)

Das Objekt zugaenglichkeit enthält:

Feld Typ Beschreibung
zugang int Barrierefreier Zugang (0/1)
toilette int Barrierefreie Toilette (0/1)
webseite string Link zu Barrierefreiheits-Informationen
allgemein string Allgemeine Hinweise zur Barrierefreiheit

Beispiel:

{
  "1234": {
    "name": "Musterhalle",
    "zusatz": "Kleiner Saal",
    "namekomplett": "Musterhalle - Kleiner Saal",
    "strassenr": "Musterstraße 1",
    "plz": "90402",
    "ort": "Nürnberg",
    "email": "info@example.com",
    "internet": "https://example.com",
    "lat": "49.4521",
    "lng": "11.0767",
    "telefon": "0911 123456",
    "telefax": "0911 123457",
    "vgn": "U1 Lorenzkirche",
    "oeffnungszeiten": "Mo–Fr 9–18 Uhr",
    "zugaenglichkeit": {
      "zugang": 1,
      "toilette": 0,
      "webseite": "https://example.com/barrierefrei",
      "allgemein": "Rampe am Seiteneingang"
    }
  }
}

TYP=VERANSTALTER

Was: Gibt Veranstalter inkl. aller Veranstalterdaten als JSON-Objekt aus, indiziert nach der Veranstalter-ID.

Standardmäßig werden alle Veranstalter ausgegeben. Mit NUREIGENE=1 wird auf die dem angemeldeten Benutzer zugeordneten Veranstalter (Veranstalter- bzw. Stadt-/PLZ-Rechte) eingeschränkt.

Weitere Parameter (optional):

Parameter Typ Beschreibung
SUCHTEXT string Filtert nach Veranstaltername. Ist der Wert numerisch, wird zusätzlich nach der Veranstalter-ID gesucht.
NUREIGENE bool 1: nur die dem Benutzer zugeordneten Veranstalter
0 / nicht gesetzt: alle Veranstalter
ANSPRECHPARTNER bool 1: je Veranstalter zusätzlich das Feld ansprechpartner ausgeben
0 / nicht gesetzt: ohne Ansprechpartner

Format: JSON

Login erforderlich: ja (ohne gültigen Login liefert die Abfrage {no login})

Ausgabe: JSON-Objekt { "<veranstalterID>": { … } }, je Veranstalter mit folgenden Feldern:

Feld Typ Beschreibung
name string Veranstaltername
strassenr string Straße und Hausnummer
plz string Postleitzahl
ort string Ort/Stadt
email string E-Mail-Adresse
internet string Webadresse
ansprechpartner array Liste der Ansprechpartner (siehe unten) - nur enthalten, wenn ANSPRECHPARTNER=1 übergeben wird
telefon string Telefonnummer
telefax string Faxnummer

Jeder Eintrag des Arrays ansprechpartner enthält:

Feld Typ Beschreibung
vorname string Vorname
nachname string Nachname
strassenr string Straße und Hausnummer
plz string Postleitzahl
ort string Ort/Stadt
funktion string Funktion/Rolle
email string E-Mail-Adresse
telefon string Telefonnummer
telefax string Faxnummer
handy string Mobilnummer

Beispiel:

{
  "789": {
    "name": "Musterverein e.V.",
    "strassenr": "Vereinsweg 5",
    "plz": "90402",
    "ort": "Nürnberg",
    "email": "kontakt@musterverein.de",
    "internet": "https://musterverein.de",
    "ansprechpartner": [
      {
        "vorname": "Erika",
        "nachname": "Mustermann",
        "strassenr": "Vereinsweg 5",
        "plz": "90402",
        "ort": "Nürnberg",
        "funktion": "Vorsitzende",
        "email": "erika@musterverein.de",
        "telefon": "0911 123456",
        "telefax": "0911 123457",
        "handy": "0170 1234567"
      }
    ],
    "telefon": "0911 123456",
    "telefax": "0911 123457"
  }
}

TYP=TAGS

Was: Gibt alle jemals verwendeten öffentlichen Tags in alphabetischer Reihenfolge aus.

Format: JSON

Login erforderlich: ja

TYP=PRIVATETAGS

Was: Gibt alle jemals von einem Benutzer verwendeten privaten Tags in alphabetischer Reihenfolge aus.

Format: JSON

Login erforderlich: ja