Azizi: Spezifikationen

Unter dem Namen Azizi betreibt Saiten eine Plattform zum Austausch von Veranstaltungsdaten. Unser Ziel ist es, die Daten möglichst vieler Kulturveranstalterinnen und -veranstaltern automatisch zu importieren und an interessierte Stellen weiter zu leiten. Wir unterstützen Institutionen bei der Implementierung einer passenden Schnittstelle, indem wir dafür eine allgemeine Spezifikation für den Datenimport zur Verfügung stellen. Zusätzlich stellen wir über eine Export-Schnittstelle die so gesammelten Daten anderen Interessierten zur Weiterverarbeitung zur Verfügung.

 

Die folgenden Informationen richten sich an Entwicklerinnen und Entwicklern, die eine solche Download-Schnittstelle erstellen oder die Daten aus dem Export nutzen möchten.

 

Import

Der Datenlieferant stellt einen Endpoint (URL) zur Verfügung, über welchen die Veranstaltungsdaten als XML-Datei gemäss folgendem Schema heruntergeladen werden können:

 

Die Daten sind recht einfach strukturiert und das Wesentliche sollte aus Schema und Beispiel ersichtlich sein:

  • Zuerst werden alle Veranstaltungen aufgeführt, danach alle referenzierten Veranstaltungsorte.
  • Die IDs sind vom System des Datenlieferanten zu definieren. Sie dienen zur Identifikation bei einem erneuten Import.
  • Strings können grundsätzlich HTML-Tags enthalten (CDATA oder escaped), allerdings empfehlen wir das nur für Description und Abstract.
  • Bilder werden von Azizi nicht heruntergeladen, die URLs werden 1:1 weitergeleitet.

 

Schnittstelle bereitstellen

  1. API-Funktion entwickeln, welche XML-Daten gemäss dieser Spezifikation generiert.
  2. XML-Download mit dem XSD-Schema überprüfen, z.B. mit diesem Validator.
  3. Zeigt der Validator keine Fehler mehr an, Download-Link an Saiten schicken zur Integration. Der Link sollte frei zugänglich sein, ohne Authentifizierung.
  4. Wenn unsere Tests ebenfalls erfolgreich sind, schalten wir den Import auf.

 

Falls du Fragen zur Spezifikation oder zum Vorgehen hast, darfst du uns gerne kontaktieren.

 

Andere Formate

Wir können Daten auch in einem anderen Format importieren (JSON, anderes XML-Schema, etc.), solange sie einem ähnlichen Datenmodell folgen.
Nimm bitte mit uns Kontakt auf, um den Entwicklungsaufwand dafür zu klären.

 

Export

Azizi stellt Veranstaltungsdaten als XML-Datei gemäss folgendem Schema zur Verfügung:

 

Bitte kontaktiere uns, wenn du an einer Freischaltung interessiert bist.

 

Andere Formate

Auf Wunsch können wir Daten auch in einem anderen Format exportieren (JSON, anderes XML-Schema, etc.) oder vorgängig filtern.
Nimm bitte mit uns Kontakt auf, um den Entwicklungsaufwand dafür zu klären.

 

Allgemeine Informationen

Du findest hier allgemeine Informationen zu Azizi:

Ostschweizer Veranstaltungsdatenbank Azizi

 

Kontakt

Technische Fragen: Manuel Märklin Programmierung, manuel.maerklin@2mp.ch

Allgemeine Fragen: Philip Stuber, stuber@saiten.ch

 

 

Impressum

Herausgeber:

 

Verein Saiten
Gutenbergstrasse 2
Postfach 2246
9001 St. Gallen

 

Telefon: +41 71 222 30 66

 

Redaktion

Corinne Riedener, Peter Surber, Roman Hertler

redaktion@saiten.ch

 

Verlag/Anzeigen

Marc Jenny, Philip Stuber

verlag@saiten.ch

 

Anzeigentarife

siehe Mediadaten

 

Sekretariat

Irene Brodbeck

sekretariat@saiten.ch

 

Kalender

Michael Felix Grieder

kalender@saiten.ch

 

Gestaltung

Samuel Bänziger, Larissa Kasper, Rosario Florio
grafik@saiten.ch

Saiten unterstützen

 

Saiten steht seit über 25 Jahren für kritischen und unabhängigen Journalismus – unterstütze uns dabei.

 

Spenden auf das Postkonto IBAN:

CH87 0900 0000 9016 8856 1

 

Herzlichen Dank!