Veranstalter » JSON

JSON

Um Ihre Veranstaltungen mittels JSON an City:Cult anzubinden, benötigen wir auf Ihrem Server eine JSON-Konforme Datei mit allen Informationen. Diese wird in regelmäßigen Abständen von unseren Crawlern besucht um alle aktuellen Informationen zu beziehen und in unser System zu integrieren.

 

Anleitung

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

Beispiel

Dieses Beispiel stellt die Struktur des JSONs dar, welches von unseren Crawlern akzeptiert wird.

{
    "name" : string,
    "street" : string,
    "postcode" : string,
    "city" : string,
    "mail" : string,
    "description" : string,
    "logo" : string,
    "geo" : {
        "latitude" : int,
        "longitude" : int
    },
    "events" : [
        {
            "name" : string,
            "description" : string,
            "category" : string,
            "startdate" : int,
            "enddate" : int, 
            "price" : string,
            "image" : string
        },
        ...
    ]
}

Spezifikation

Allgemein ist als Schriftkodierung UTF-8 zu wählen, da sonst eine reibungslose Darstellung nicht gewährleistet werden kann. Für die JSON-Schnittstelle werden folgende Datenfelder akzeptiert:

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