Mittels read-api können Daten via HTTP abgerufen werden, um sie beispielsweise programmatisch auf einer Webseite auszuspielen oder auch eine Integration mit einem externen System herzustellen.
Aktuell stehen folgende Artist-Endpunkte zur Verfügung:
GET /artists
(zur Abfrage einer Liste an Künstler:innen)GET /
(zur Abfrage einer:s einzelnen Künstler:in)artist
/:slugGET /
(zur Abfrage der Events einer/s einzelnen Künstler:in)artist
/:slug/events
Alle weiteren technischen Informationen findest du auf der read-api: events Seite.
GET /artists
Zur Abfrage einer Liste an Künstler:innen.
Parameter
Parameter für Filter, Pagination und Sortierung können im Query-String angegeben werden.
Event-Filter
Key | Typ bzw. Wert |
filter.name | Suchtext für Name |
Pagination
Key | Typ bzw. Wert |
pagination.take | Maximale Anzahl zurückgegebener Events pro Aufruf Default: 100 |
pagination.skip | Zu überspringende Events Default: 0 |
Sortierung
Key | Typ bzw. Wert |
sort.column | „status“ | „eventType“ | „start“ | „rooms“ Default: „start“ |
sort.direction | „asc“ | „desc“ Default: „asc“ |
Artist Payload
export interface ArtistExportPayload {
slug: string
name: string
description?: string
memo?: string
images?: ArtistExportPayloadImage[]
files?: ArtistExportPayloadFile[]
links?: ArtistExportPayloadLink[]
contacts?: {
role: string
displayName: string
email: string
phone: string
}[]
shows?: {
slug: string
name: string
releasesAt?: Date
memo?: string
images?: ArtistExportPayloadImage[]
files?: ArtistExportPayloadFile[]
showInformations?: (Information | undefined)[]
}[]
artistInformations?: (Information | undefined)[]
}
export type Information = {
name: string
value: string
tags?: string[]
}
export type ArtistEventsRooms = {
name: string
location: string
address?: {
street: string
addStreet: string
zip: string
city: string
country: string
}
}
export type ArtistExportPayloadImage = {
name: string
description: string
tags: string[]
sizes: Record<string, string>
}
export type ArtistExportPayloadFile = {
name: string
description: string
path: string
preview: string
download: string
tags: string[]
}
export type ArtistExportPayloadLink = {
type: string
value: string
}
Bilder
Jedes Bild wird mit den folgenden Informationen und Bildgrößen ausgespielt.
name:
description: string
sizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840]
Dateien
Sollen Dateien oder Bilder mit ausgespielt werden, müssen diese auf öffentlich gesetzt werden. Vertrauliche Dateien und Bilder werden nicht ausgespielt.
