API

Estimated reading: 2 minutes

Aktuell bieten wir eine REST-API an, über die Veranstaltungsdaten abgerufen werden können.

API-Token

Damit der Zugriff möglich ist, muss einmalig ein Token erzeugt werden und als Bearer bei ihren Anfragen im header mitgegeben werden.
Um ein API-Token zu erzeugen, klicke im Team-Menü auf API-Token (https://app.eventbrain.de/team/api-tokens).

Vergib dann einen aussagekräftigen Namen für die externe Freigabe. Z.B. “Website-Veranstaltungskalender”. Nach dem Klick auf “Erstellen” wird das Token erzeugt und einmalig angezeigt. Speichere das Token ab, es kann hier nicht erneut angesehen werden. Gib das Token ggf. an deinen technischen Dienstleister weiter, der die Anbindung an die eventbrain-API umsetzen soll.

Funktionen, Daten und Testcalls

API-Docs JSON: https://app.eventbrain.de/docs/api-docs.json

Hier können die Funktionen angesehen und mit Calls getestet werden:
https://app.eventbrain.de/api/docs

Limit

Wir erlauben keinen Liveabruf der Daten. Die Eventinformationen müssen durch Drittsysteme in regelmäßigen Abständen abgerufen und selber gespeichert werden. Typischerweise ist das z.B. ein bestehender Online-Veranstaltungskalender auf der eigenen Website.

Aufbau

Wenn du die Daten z.B. für den Veranstaltungskalender auf der eigenen Website abrufen möchtest, dann kannst du zunächst mit getEvents alle für dich relevanten Events filtern. Du solltest dich fragen, welche du abrufen und auf der eigenen Website anzeigen möchtest. Welchen Status soll die Veranstaltung haben? Was ist mit vergangenen Veranstaltungen?
Die Response auf getEvents sind nur rudimentäre Daten zu einem Event. Details zu einem Event erhältst du mit dem Abruf “get events/{$id}” .
Innerhalb dessen gibt es dann ggf. noch Verweise auf die Künstler bzw. andere Programmpunkte (program_items). Zu diesen erhältst du gleich beim Event-Abruf einige Informationen. Weitere Details zum Program des Künstlers kannst du dann über die program_item.id und den GET-Abruf “/programs/{id}” holen.
Tiefergehende Informationen zum Künstler über den Namen hinaus erhältst du über den GET-Abruf “/artists/{id}”. Die ID des Künstlers findest du ebenfalls im program_item (program_items.artist.id)

CONTENTS