Datenanschluss für Apps und KI

Für Entwickler

Die Schnittstelle in Kürze. Den Zugang mit API-Schlüssel und die vollständige Beschreibung bekommen Sie mit dem Paket.

Endpunkte

GET	`/api/v1/events`Veranstaltungen mit Ort, Zeit, Preis und Status	Veranstaltungen mit Ort, Zeit, Preis und Status
GET	`/api/v1/event-series`Produktionen mit allen Terminen	Produktionen mit allen Terminen
GET	`/api/v1/locations`Orte mit Adresse und Öffnungszeiten	Orte mit Adresse und Öffnungszeiten
GET	`/api/v1/artists`Künstler und Ensembles	Künstler und Ensembles
GET	`/api/v1/festivals`Festivals mit Zeitraum	Festivals mit Zeitraum
GET	`/api/v1/works`Werke, etwa Opern oder Stücke	Werke, etwa Opern oder Stücke
GET	`/api/v1/search`Suche über alles, auch in ganzen Sätzen	Suche über alles, auch in ganzen Sätzen
GET	`/api/v1/exports/{id}/latest`Die neueste Datei eines Exports	Die neueste Datei eines Exports
POST	`/api/v1/partner/event-series/bulk`Eigene Veranstaltungen gesammelt übertragen	Eigene Veranstaltungen gesammelt übertragen

Filter für Veranstaltungen

region: Region, auch mit Unterregionen
near, radius: Umkreis um einen Punkt
dateFrom, dateTo: Zeitraum
genreIds: Genres
isFree, isOpenAir, isPremiere: nur gratis, Open Air oder Premiere
search, semantic: freie Suche oder ganzer Satz
lang: eine der zehn Sprachen
paginate=cursor: fortlaufend statt nummeriert

Zugang

Jede Anfrage trägt den Schlüssel Ihrer Organisation im Header X-API-Key. Jede Antwort zeigt in X-RateLimit-Remaining, wie viel vom Kontingent übrig ist.

Eine Anfrage

curl "$CIXTRA_API/api/v1/events" \
  -G -d region=graz -d lang=en \
  -d isFree=true \
  -H "X-API-Key: $CIXTRA_KEY"

Im Einzelnen

Was Sie abfragen

Alles, was CIXTRA kennt, über eine Schnittstelle.

Inhalte: Veranstaltungen, Termine, Orte, Künstler, Festivals, Werke, Genres und Regionen.
Sprache: Jede Antwort in einer der zehn Sprachen, die Sie angeben.
Seitenweise: Große Ergebnismengen kommen seitenweise, nummeriert oder fortlaufend.

Was ein Eintrag mitbringt

Genug, um daraus direkt eine Ansicht zu bauen.

Zeit und Preis: Beginn mit Zeitzone, Preise und Link zum Ticket.
Status: Ob ein Termin abgesagt, ausverkauft oder verschoben ist.
Verknüpft: Ort, Festival, Künstler, Werke, Genres und Bilder.
Bewertungen: Neun Gruppen auf festen Skalen, etwa Publikum, Stimmung und Barrierefreiheit.

Auch ohne Abfrage

Für Systeme, die lieber Dateien abholen oder selbst Daten liefern.

Dateien: Wer lieber Dateien abholt, bekommt die Daten als XML, JSON, CSV oder HTML.
Daten einspielen: Partner übertragen eigene Orte, Veranstaltungen und Termine gesammelt.

In diesen Produkten

Incoming Suite

Für Bahn, Bus und Hotels: was gerade in der Nähe los ist.

Zum Produkt

Individuell

API, Export, Widget, Infoscreens und Newsletter frei kombiniert.