EventDB General API (0.6.1)

Download OpenAPI specification:Download

Generische Schnittstelle für EventDB

events

Alle Daten zu Veranstaltungen

Gibt alle Veranstaltungen in der Datenbank zurück

Die Collection ist paginiert. Sie ist nach ID aufsteigend sortiert. Dieser Endpunkt gibt auch unveröffentlichte Veranstaltungen zurück. Diese müssen clientseitig herausgefiltert werden (published=false).

query Parameters
id
Array of strings <uuid> <= 50 items

Array von IDs, um mehrere Veranstaltungen abzufragen. Wird der ID-Filter verwendet, kann die Collection nicht paginiert werden. Wird eine ID mehrfach angegeben, wird das Item nur einmal zurückgegeben. Wenn zu einer ID kein Item gefunden wurde, wird sie ignoriert.

page
integer
Default: 1

Die abzurufende Seite der Collection

pageSize
integer <= 2000
Default: 100

Die Anzahl der Elemente je Seite

header Parameters
If-Modified-Since
string

Für bedingte Abfragen, um Ressourcen auf Aktualität zu prüfen

Responses

Response samples

Content type
application/json
[]

Gibt die Veranstaltung mit der ID {id} zurück

Dieser Endpunkt gibt auch unveröffentlichte Veranstaltungen zurück. Diese müssen clientseitig herausgefiltert werden (published=false).

path Parameters
id
required
string <uuid>

ID der Veranstaltung

header Parameters
If-Modified-Since
string

Für bedingte Abfragen, um Ressourcen auf Aktualität zu prüfen

Responses

Response samples

Content type
application/json
{}

Gibt ein Changelog aller Änderungen zurück

Das Changelog liefert eine Liste aller geänderten Veranstaltungen mit UUID, Zeitstempel und Art der Änderung ('create' für neue Items, 'delete' für gelösche Items und 'update' für geänderte Items). In Einzelfällen kann es vorkommen, dass hier als geändert gelistete Items sich nicht in einem für die API relevantem Feld geändert haben.

query Parameters
since
required
integer <timestamp>
Example: since=1564740000

Änderungen seit dem gegebenen Zeitpunkt

header Parameters
If-Modified-Since
string

Für bedingte Abfragen, um Ressourcen auf Aktualität zu prüfen

Responses

Response samples

Content type
application/json
[
  • {
    }
]

persons

Alle Daten zu Personen

Gibt alle Personen aus der Datenbank zurück

Die Collection ist paginiert. Sie ist nach ID aufsteigend sortiert.

query Parameters
id
Array of strings <uuid> <= 50 items

Array von IDs, um mehrere Personen abzufragen. Wird der ID-Filter verwendet, kann die Collection nicht paginiert werden. Wird eine ID mehrfach angegeben, wird das Item nur einmal zurückgegeben. Wenn zu einer ID kein Item gefunden wurde, wird sie ignoriert.

page
integer
Default: 1

Die abzurufende Seite der Collection

pageSize
integer <= 2000
Default: 100

Die Anzahl der Elemente je Seite

header Parameters
If-Modified-Since
string

Für bedingte Abfragen, um Ressourcen auf Aktualität zu prüfen

Responses

Response samples

Content type
application/json
{}

Gibt die Person mit der ID {id} zurück

path Parameters
id
required
integer

ID der Person

header Parameters
If-Modified-Since
string

Für bedingte Abfragen, um Ressourcen auf Aktualität zu prüfen

Responses

Response samples

Content type
application/json
{}

Gibt ein Changelog aller Änderungen zurück

Das Changelog liefert eine Liste aller geänderten Veranstaltungen mit UUID, Zeitstempel und Art der Änderung ('create' für neue Items, 'delete' für gelösche Items und 'update' für geänderte Items). In Einzelfällen kann es vorkommen, dass hier als geändert gelistete Items sich nicht in einem für die API relevantem Feld geändert haben.

query Parameters
since
required
integer <timestamp>
Example: since=1564740000

Änderungen seit dem gegebenen Zeitpunkt

Responses

Response samples

Content type
application/json
[
  • {
    }
]

meta

Allgemeine Informationen

Verfügbare Sprachen

Alle im System verfügbaren Sprachen. Sprachkürzel nach ISO-639-1.

Responses

Response samples

Content type
application/json
[
  • "de",
  • "en"
]