API Endpoints

API

Mit der API ist es möglich Konferenzen durch eine andere Anwendung erzeugen zu lassen.

Es sollten nur Zugriffe von einem Backend-Server auf den Jitsi-Admin durchgeführt werden. Alle Request müssen mit dem in den Enterprise Einstellungen erstellten API-Tokens als Authorization Header (Bearer Token) durchgeführt werden

Infos zu einer Konferenz (GET /api/v1/info/{uidReal})

Request

http://localhost:8000/api/v1/info/57d4d52d3c1f38c28e9f101f031a631f

Response

{
"error": false,
"teilnehmer": [
"teilnehmer@email.de"
],
"start": "2021-02-02CET13:00:00",
"end": "2021-02-02CET13:45:00",
"duration": 45,
"name": "testAPINEW",
"moderator": "email@moderator.de",
"server": "serverurl",
"joinBrowser": "http://localhost:8000/room/join/b/84",
"joinApp": "http://localhost:8000/room/join/a/84"
}

Eine Konferenz erstellen (POST /api/v1/room)

Request:

http://localhost:8000/api/v1/room
?email=email@moderator.com
&name=testAPINEW
&duration=70
&server=serverURL
&start=2021-02-01T13:00
&keycloakId=id_des_Users (optional nur wenn der selbe Keycloak verwendet wird)

Response:

{
"error": false,
"uid": "57d4d52d3c1f38c28e9f101f031a631f",
"text": "Meeting erfolgreich angelegt"
}

Eine Konferenz bearbeiten (PUT /api/v1/room)

Request:

http://localhost:8000/api/v1/room
?name=testAPINEW
&duration=45
&server=serverURL
&start=2021-02-02T13:00
&uid=57d4d52d3c1f38c28e9f101f031a631f

Response:

{
"error": false,
"uid": "57d4d52d3c1f38c28e9f101f031a631f",
"text": "Meeting erfolgreich geändert"
}

Eine Konferenz Löschen (DELETE /api/v1/room)

Request:

http://localhost:8000/api/v1/room
?uid=57d4d52d3c1f38c28e9f101f031a631f

Response

{
"error": false,
"text": "Erfolgreich gelöscht"
}

Einen Teilnehmer zu einer Konferenz hinzufügen (POST /api/v1/user)

Request:

http://localhost:8000/api/v1/user
?uid=57d4d52d3c1f38c28e9f101f031a631f
&email=test@local.de

Response

{
"uid": "57d4d52d3c1f38c28e9f101f031a631f",
"user": "test@local.desd",
"error": false,
"text": "Teilnehmer test@local.desd erfolgreich hinzugefügt"
}

Einen Teilnehmer von einer Konferenz löschen (DELETE / api/v1/user)

Request:

http://localhost:8000/api/v1/user
?uid=57d4d52d3c1f38c28e9f101f031a631f
&email=test@local.de

Response

{
"uid": "57d4d52d3c1f38c28e9f101f031a631f",
"user": "test@local.desd",
"error": false,
"text": "Teilnehmer test@local.desd erfolgreich gelöscht"
}

Infos zu einem User (GET /api/v1/serverInfo)

Request

http://localhost:8000/api/v1/serverInfo
?email=user@userToCHeck.de
&keycloakId=id (optional nur wenn der selbe Keycloak verwendet wird)

Response

{
"server": [
"url1",
"url2",
"url3"
],
"email": "user@userToCHeck.de",
"error": false
}