GET /api/developer/v1/events
Events abholen
Nur mit Bot-Token. Folge-Feed für Bots ohne erreichbare Webhook-Adresse. Der Cursor heißt hier after. nextCursor ist nur null, wenn du ohne after abrufst und es noch kein Event gab. Dann rufst du weiter ohne after auf, sonst immer mit dem letzten nextCursor. Eine leere data-Liste heißt: aufgeholt. Der Feed liefert ein Event erst, wenn es mindestens 30 Sekunden alt ist. Für Echtzeit nutze Webhooks.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
| after | Query | string | nein | Folge-Cursor: der `nextCursor` des letzten Aufrufs. Ohne Wert beginnt der Feed beim ältesten verfügbaren Event. |
| limit | Query | integer (int32) | nein | Einträge je Seite, 1 bis 100. Standard 25. Ein Wert außerhalb ergibt 400 `VALIDATION_ERROR`. |
Antworten
OK
application/json
SchemaDevEventDtoPage
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| data | DevEventDto[] | ja | |
| data[].id | string (uuid) | ja | |
| data[].type | string | ja | Art des Events. Sie bestimmt die Form von `data`. |
| data[].serverId | string (uuid) | null | ja | |
| data[].createdAt | string (date-time) | ja | |
| data[].data | DevActivityDto | DevInstallationDto | DevPingDataDto | ja | Hängt von `type` ab: `server.activity` liefert eine Aktivität, `installation.created` und `installation.deleted` eine Installation, `ping` die Daten der Testzustellung. |
| data[].data (DevActivityDto).id | string (uuid) | ja | |
| data[].data (DevActivityDto).serverId | string (uuid) | ja | |
| data[].data (DevActivityDto).category | string | ja | Gruppe des Eintrags. |
| data[].data (DevActivityDto).type | string | ja | |
| data[].data (DevActivityDto).severity | string | ja | Gewicht des Eintrags. |
| data[].data (DevActivityDto).source | string | ja | Wer den Eintrag ausgelöst hat. `api` ist ein persönliches Token, `bot` ein Bot. |
| data[].data (DevActivityDto).title | string | ja | |
| data[].data (DevActivityDto).createdAt | string (date-time) | ja | |
| data[].data (DevInstallationDto).id | string (uuid) | ja | |
| data[].data (DevInstallationDto).serverId | string (uuid) | ja | |
| data[].data (DevInstallationDto).grantedScopes | string[] | ja | |
| data[].data (DevInstallationDto).eventTypes | string[] | ja | |
| data[].data (DevInstallationDto).status | string | ja | Zustand der Installation. |
| data[].data (DevInstallationDto).createdAt | string (date-time) | ja | |
| data[].data (DevPingDataDto).botId | string (uuid) | ja | |
| data[].data (DevPingDataDto).message | string | ja | |
| nextCursor | string | null | ja |
{
"data": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type": "string",
"serverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2026-10-05T12:00:00Z",
"data": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"category": "string",
"type": "string",
"severity": "string",
"source": "string",
"title": "string",
"createdAt": "2026-10-05T12:00:00Z"
}
}
],
"nextCursor": "string"
}Codebeispiele
curl "https://api.zenit-hosting.de/api/developer/v1/events" \ -H "Authorization: Bearer $ZENIT_TOKEN"
GET /api/developer/v1/installations
Installationen des Bots auflisten
Nur mit Bot-Token (ein persönliches Token bekommt 403 FORBIDDEN): alle Server, auf denen dieser Bot installiert ist, samt zugestimmten Scopes und abonnierten Events. Seitenweise Liste: limit (1 bis 100, Standard 25) und cursor. nextCursor ist null auf der letzten Seite, sonst der Wert für den nächsten Aufruf.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
| limit | Query | integer (int32) | nein | Einträge je Seite, 1 bis 100. Standard 25. Ein Wert außerhalb ergibt 400 `VALIDATION_ERROR`. |
| cursor | Query | string | nein | Wert von `nextCursor` der vorherigen Seite. Nicht ändern, nicht auswerten. Ein ungültiger Cursor ergibt 400 `VALIDATION_ERROR`. |
Antworten
OK
application/json
SchemaDevInstallationDtoPage
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| data | DevInstallationDto[] | ja | |
| data[].id | string (uuid) | ja | |
| data[].serverId | string (uuid) | ja | |
| data[].grantedScopes | string[] | ja | |
| data[].eventTypes | string[] | ja | |
| data[].status | string | ja | Zustand der Installation. |
| data[].createdAt | string (date-time) | ja | |
| nextCursor | string | null | ja |
{
"data": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"grantedScopes": [
"string"
],
"eventTypes": [
"string"
],
"status": "string",
"createdAt": "2026-10-05T12:00:00Z"
}
],
"nextCursor": "string"
}Codebeispiele
curl "https://api.zenit-hosting.de/api/developer/v1/installations" \ -H "Authorization: Bearer $ZENIT_TOKEN"
Bereich Bots und Events geladen, 2 Endpunkte.