Veranstalter » XML

XML

Um Ihre Veranstaltungen per XML an City:Cult anbinden zu können, benötigen wir auf Ihrem Server eine XML-Datei mit verschiedenen Informationen. Diese wird in regelmäßigen Abständen mit unseren Crawlern besucht um alle aktuellen Informationen zu beziehen und in unser System zu integrieren.

 

Anleitung

  1. Legen Sie eine XML-Datei nach der unten aufgeführten Spezifikation auf ihrem Webserver an. Als Dateiname empfehlen wir events.xml.
  2. Überprüfen Sie, ob die XML-Datei erreichbar ist. Geben Sie in Ihren Browser die entsprechende URL ein. Z.B. http://www.example.com/events.xml.
  3. Senden Sie uns eine E-Mail an die Adresse events@citycult.org in der Sie uns mitteilen unter welcher Adresse wir die XML-Datei finden können.

Beispiel

Dieses Beispiel stellt die Struktur der XML-Datei dar, die von unseren Crawlern akzeptiert wird.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<venue>
    <name></name>
    <street></street>
    <postcode></postcode>
    <city></city>
    <mail></mail>
    <description></description>
    <logo></logo>
    <geo>
        <latitude></latitude>
        <longitude></longitude>
    </geo>
    <events>
        <event>
            <name></name>
            <description></description>
            <category></category>
            <startdate></startdate>
            <enddate></enddate>
            <price></price>
            <image></image>
        </event>
        ...
    </events>
</venue>

Spezifikation

Das root-Element der XML-Datei ist jeweils das Objekt venue. Für dieses werden folgende Datenfelder akzeptiert:

Objekt Pflicht? Beschreibung
name Ja Enthält den Namen des Veranstaltungsortes
street Ja Die Adresse in der der Veranstaltungsort zu finden ist
postcode Ja
city Ja
mail Nein Diese Mail-Adresse soll ausschließlich dazu verwendet werden, Sie bei Änderungen der API entsprechend rechtzeitig zu benachrichtigen
description Nein Eine Beschreibung, die den Veranstaltungsort möglichst gut charakterisiert
logo Nein Der Pfad, an dem ein Bild, Logo o.ä. vom Veranstaltungsort zu finden ist
geo Nein Geo-Koordinaten im Grad-Format (dezimal); z.b. 51.331161,12.374618
latitude Nein
longitude Nein
events Ja Liste der Veranstaltungen
event Ja Einzelne Veranstaltung
name Ja Name der Veranstaltung
description Ja Möglichst aussagekräftige Beschreibung der Veranstaltung
category Ja Auswahl zwischen nightlife/live/sport/culture/misc
startdate Ja Im Format yyyy-MM-dd’T'HH:mm:ss z.b. “1970-01-01T12:00:00″
enddate Ja Im Format yyyy-MM-dd’T'HH:mm:ss z.b. “1970-01-01T12:00:00″
price Ja Der Eintrittspreis zur Veranstaltung
image Nein Pfad zum Plakat, Logo, Flyer o.ä. zur Veranstaltung