Userstatus Api
- Pascal Kordas
- Dennis Scheidner
- Andreas Treuwerth
Teil des Integration Service
Benutzer Status abrufen
Endpunkt: GET - api/v1/userstatus/{userid}
Version: 2.22.117
Beschreibung: Gibt den Status des angegebenen Benutzers zurück
Beispiel Request:
/v1/userstatus/2
Beispiel Reponse:
[
{
"statusId": "35464b26-05d6-45b2-8f5f-88b148d41b88",
"userId": 2,
"tag": "80.1.0",
"moduleKey": "de.die-groupware.legacy",
"status": 1,
"category": 1,
"priority": 100,
"fromDate": "2023-03-30T10:06:45",
"tooDate": "0001-01-01T00:00:00",
"imageAsSvg": Das ist mein erster Benutzerstatus,
"message": "test",
"link": null,
"linkTitle": ""
},
{
"statusId": "f5f65f25-0f07-4e9d-99bd-fbefd6caac02",
"userId": 2,
"tag": "80.2.0",
"moduleKey": "de.die-groupware.legacy",
"status": 0,
"category": 1,
"priority": 50,
"fromDate": "2023-04-04T08:59:59",
"tooDate": "0001-01-01T00:00:00",
"imageAsSvg": null,
"message": "Das ist mein Zweiter Benutzerstatus",
"link": null,
"linkTitle": ""
}
]Das ImageAsSvg Feld ist ein Base64 Encodeter SVG string.
Benutzerstatus hinzufügen
Endpunkt: POST - /v1/userstatus/{userid}
Version: 2.22.117
Beschreibung: Erstellt einen Benutzerstatus
Beispiel Request:
/v1/userstatus/2Body:
Im ImageAsSvg ist stumpf der Inhalt einer SVG (XML) enthalten
Sollte das TooDate Feld nicht gebraucht werden muss hier ein MinDate eingetragen werden.
Felder Beschreibung:
Feldname | Beschreibung | Optional | Besonderheit |
|---|---|---|---|
tag | Kann beliebiges reingeschrieben werden. Ist z.B. dazu da um Metadaten o.Ä. zwischen zu speichern. Die Variable wird von antony aber nicht benutzt! Diese ist nur für die Eigenentwicklung |
| |
modulekey | Dient dazu um nachvollziehen zu können woher der Userstatus kommt. |
| |
status | Muss gesetzt werden um Anwesenheitsstatus eines Nutzer zu ändern.
|
| |
category | Setzt die Kategorie des Status Mögliche Werte: |
| |
priority | Wichtig für antony um zu berechnen welcher Kumulierter Status angezeigt wird.
Höherer Wert = Höhere Priorität innerhalb antonys |
| |
fromDate | Kann gesetzt werden um anzugeben seit wann dieser Status existiert. In antony steht bei dem Status dann z.B.:  | Zeit als UTC angeben im ISO Format! | |
tooDate | Kann gesetzt werden um anzugeben bis wann dieser Status existiert.  In Kombination mit dem ‘fromDate’ steht dann z.B. folgendes in antony: | Zeit als UTC angeben im ISO Format! Wenn man am 20.06.2024 um 04:00 Uhr den Status erstellen möchte | |
imageAsSvg | Kann genutzt werden um einen SVG string zu übertragen um ein Icon im Userstatus anzuzeigen | Hier nur den xml string aus der .svg Datei angeben | |
message | Kann genutzt werden um eine Nachricht an den Userstatus zu hängen. Dieser wird dann als ‘Titel’ für den Userstatus genutzt |
| |
link | Hier kann ein Link zu einem/r Server/Website reingeschrieben werden. Im Userstatus ist wird dieser angezeigt und ist auch klickbar. Es wird dann der Standardbrowser geöffnet mit dem Link |
| |
linkText | Wenn ein ‘link’ angegeben wird kann der linkText statt des Links im Userstatus angezeigt werden wie es z.B. bei Hyperlinks der Fall ist |
|
Beispiel response:
Benutzerstatus aktualisieren
Endpunkt: PUT- /v1/userstatus/{userid}/{statusid}
Version: 2.22.117
Beschreibung: Aktualisiert den angegebenen status
Beispiel Request:
Body:
Felder Beschreibung:
Feldname | Beschreibung | Optional | Besonderheit |
|---|---|---|---|
tag | Kann beliebiges reingeschrieben werden. Ist z.B. dazu da um Metadaten o.Ä. zwischen zu speichern. Die Variable wird von antony aber nicht benutzt! Diese ist nur für die Eigenentwicklung |
| |
modulekey | Dient dazu um nachvollziehen zu können woher der Userstatus kommt. |
| |
status | Muss gesetzt werden um Anwesenheitsstatus eines Nutzer zu ändern.
Mögliche Werte: |
| |
category | Setzt die Kategorie des Status Mögliche Werte: |
| |
priority | Wichtig für antony um zu berechnen welcher Kumulierter Status angezeigt wird.
Höherer Wert = Höhere Priorität innerhalb antonys |
| |
fromDate | Kann gesetzt werden um anzugeben seit wann dieser Status existiert. In antony steht bei dem Status dann z.B.: | Zeit als UTC angeben im ISO Format! Wenn man am 20.06.2024 um 02:00 Uhr den Status erstellen möchte | |
tooDate | Kann gesetzt werden um anzugeben bis wann dieser Status existiert. In Kombination mit dem ‘fromDate’ steht dann z.B. folgendes in antony: | Zeit als UTC angeben im ISO Format! Wenn man am 20.06.2024 um 04:00 Uhr den Status erstellen möchte | |
imageAsSvg | Kann genutzt werden um einen SVG string zu übertragen um ein Icon im Userstatus anzuzeigen | Hier nur den xml string aus der .svg Datei angeben | |
message | Kann genutzt werden um eine Nachricht an den Userstatus zu hängen. Dieser wird dann als ‘Titel’ für den Userstatus genutzt |
| |
link | Hier kann ein Link zu einem/r Server/Website reingeschrieben werden. Im Userstatus ist wird dieser angezeigt und ist auch klickbar. Es wird dann der Standardbrowser geöffnet mit dem Link |
| |
linkText | Wenn ein ‘link’ angegeben wird kann der linkText statt des Links im Userstatus angezeigt werden wie es z.B. bei Hyperlinks der Fall ist |
|
Beispiel response:
Benutzerstatus löschen
Endpunkt: DELETE - /v1/userstatus/{userid}/{statusid}
Version: 2.22.117
Beschreibung: Löschen des angegebenen Benutzerstatus
Beispiel Request:
Beispiel response: